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HOW TO USE THIS BOOK 


Unix for Mac: Your visual blueprint to maximizing the 
foundation of Mac OS X uses straightforward examples to 
teach you how to get the most out of your Mac OS X 
system by fully using its Unix capabilities. 

To get the most out of this book, you should read each 
chapter in order from beginning to end. Each chapter 
introduces new ideas and builds on the knowledge 
learned in previous chapters. After you become familiar 
with Unix for Mac, you can use this book as an informative 
desktop reference. 


Who This Book Is For 


If you are looking for a resource that will help you learn 
how to maximize the Unix underpinnings of Mac OS X, 
Unix for Mac: Your visual blueprint to maximizing the 
foundation of Mac OS X is the book for you. 


No prior experience with operating systems is required, 
but familiarity with UNIX or Mac is an asset. 


What You Need To Use This Book 


To perform the tasks in this book, you need a power PC 
running Mac OS X v.10.2. or higher. 


The Conventions In This Book 


A number of typographic and layout styles have been used 
throughout UNIX for Mac: Your visual blueprint to 
maximizing the foundation of Mac OS X to distinguish 
different types of information. 


Courier Font 


Indicates the use of Unix commands, scripting commands 
such as shell or Perl commands, source code such as C or 
Java commands, and HTML. 


Bold 
Indicates information that must be typed by you. 


Italics 
Indicates a new term being introduced. 


Apply. 
it 


An Apply It section usually contains a segment of code 
that takes the lesson you just learned one step further. 
Apply It sections offer inside information and pointers that 
can be used to enhance the functionality of your code. 


Extra 


An Extra section provides additional information about the 
task you just accomplished. Extra sections often contain 
interesting tips and useful tricks to make working with 
Mac OS X easier and more efficient. 


The Organization Of This Book 


UNIX for Mac: Your visual blueprint to maximizing the 
foundation of Mac OS X contains 18 chapters. 


The first chapter, "Get Started with Unix," introduces 

you to the Unix features that are built directly into the 
operating system and constitute the foundation on which 
all Mac OS X applications run. You can access this 
foundation directly by using the terminal application. 
Chapter 2, "Work with Files,” illustrates how the Unix shell 
enables you to move through the file system and access 
parts of your hard drive that are unavailable through the 
Finder. 


Chapter 3, "Work with Directories," shows how you can 
create, delete, move, copy, change, and navigate files and 
directories. 


Chapter 4, "Work with Text," demonstrates how you can 
extract, view, and compare text files, and to chain text 
commands together. 


Chapter 5, "Work with Text Editors," illustrates how you 

can edit a text file in Unix, such as an application's 
configuration file, a Web page, or a Perl program. Mac OS X 
offers three text editors — pico, vi, and emacs — for editing 
text files, 


Chapter 6, "Customize Your Shell," shows you how to 
configure your terminal shell to fit your preference. 


Chapter 7, "Work with Processes," demonstrates how you 
can suspend, start, run, kill, list, and monitor processes. 


Chapter 8, "Automate Shell Tasks," illustrates how a shell 
script containing a set of instructions is typed in a terminal 
window and executed to form a basic Unix program. You 
will also learn how to set scripts to execute at a specific 
time of day or date using cron. 


Chapter 9, "Combine Unix and Aqua," demonstrates how 
you can best take advantage of running Aqua — OS X 
GUI — alongside the Unix command line. 


Chapter 10, "Work with Internet Commands," shows how 
you can connect to another computer and execute 
commands or download files. 


Chapter 11, "System Administration Commands," details 
how you can assign yourself as the system administrator of 
your system. 


Chapter 12, "Install Unix Applications," guides you 
through the download and installation of programs, some 
free and some not, which run on Mac OS X. These are 
often downloaded via the Internet, and come as packages 
or archives. 


Unix for Mac: 
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Chapter 13, "Install and Use Internet Applications," lists 
some of the most popular programs that you can 
download and install for better access via the shell to the 
Internet. 


Chapter 14, "Serve Web Pages with Apache," shows you 
how to use the Apache server on your computer to serve 
live pages on the Internet, or as your own test bed for Web 
site creation. 


Chapter 15, "Work with Perl," shows you how to use Perl 
for a variety of tasks from system administration to Web 
pages. Mac OS X comes with Per! pre-installed. 


Chapter 16, "Run the X Window System," shows you how 
to get the advantage of using both Mac and Unix graphical 
programs by running an X server with the Mac OS X GUI 
called Aqua. 


Chapter 17, "Install X Window System Software," 
introduces you to free alternatives to expensive 
commercial software such as the GIMP that provides the 
functions of Photoshop, and Open Office.org that is a free 
equivalent of Microsoft Office. 

The final chapter, "Develop Unix Applications," shows you 


how to create and run programs in other languages on 
Mac OS X, 


What's On The CD-ROM Disc 


The CD-ROM disc included in this book contains office 
tools, such as OpenOffice.org, Gimp, XFree, Fink, and 
other open source software. See the appendix for more 
information on software included on the companion CD. 


INTRODUCTION TO UNIX 


by learning the ins and outs of the Unix operating 

system. Even though you may not know it, you use 
Unix every time you turn on your Mac OS X computer, 
because at the core, Mac OS X is Unix. 


Y ou can get full use out of your Mac OS X computer 


For most users, the Unix foundation for Mac OS X operates 
behind the scenes; they may use Mac OS X for years without 
needing to directly access the Unix features described in this 
book. However, by understanding and using Unix, you can 
take full advantage of the power of Mac OS X. 
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The original version of UNIX was created in the 1960s in 
the Bell Labs of AT&T, by researchers who devised a 
multi-user operating system for large mainframe 
computers. The role of an operating system like Unix is 
to provide basic functions such as running programs, 


BSD Unix System 


From AT&T, the Unix system spread to research 
universities, that quickly adopted it. The University of 
California, Berkeley, was one of the earliest adopters 
and developers of Unix. The staff and students at 
Berkeley added many more features to this ever- 
evolving operating system. The updated Berkeley 


Open Source 


Computer programs begin as source code, written in a 
computer language by programmers. They are then 

transformed into applications that you can run through 
a process called compiling, which translates the source 
code into commands that a computer can understand. 


You do not need the source code to run the program. 
However, if you have access to the source code, you can 
recreate the application, or change the application by 
modifying the source code. Many commercial 
companies do not make their source code public 
because, if they did, nobody would buy their software. 
Other groups make their source code freely available to 
the public; this is known as open source. 


-? oe 


saving data, and sending output to a monitor or other 
device. On your Apple computer, these functions are 

provided by the Mac OS X operating system, a direct 

descendent of the original Unix operating system. 


version of Unix was known as Berkeley Software 
Distribution (BSD), and it forms a major branch of the 
operating system family tree. The BSD family tree must 
be an apple tree, because the most recent fruit is Mac 
OS X, which is based on the BSD Unix system from 
Berkeley. 


Free Operating Systems and Applications 


The most famous open-source software is the free 
operating system known as Linux. A young, Finnish 
software developer named Linus Torvalds created Linux 
as a version of Unix that could run on Intel-style PCs, as 
well as other hardware. In addition to Linux, there are 
several free versions of BSD Unix, known as Free BSD, 
Open BSD, and Net BSD. Mac OS X is a cousin to these 
free BSD operating systems, but is not itself a free 
operating system. 


The largest collection of open-source applications 
comes from the GNU project, developed by the Free 
Software Foundation. GNU is an acronym for GNU's 
Not Unix, and yes, that is self-referential. Many of the 
Unix applications that you run are based on GNU code. 
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Up to and including Mac OS 9, the Apple operating 
system was not based on Unix. There was no Unix code 
at the core of Mac OS 9 or earlier systems; instead, they 
used an operating system that was developed within 
Apple Computer. 


Darwin 


When it was time to create the next version of Mac OS, 
Apple chose to base it on a BSD Unix foundation, 
modified for the specific needs of Apple. This version of 
BSD Unix was called Darwin. Darwin consists primarily 
of the Unix kernel, which is the program that runs and 
manages all the processes and shells of the operating 
system, along with associated programs and files that 
make the kernel run. The source code for Darwin is 
open and available on the Web from http://developer. 
apple.com/darwin/, although you will probably never 
need to use it. 


Not all the Mac OS X operating system is open source; 
for example, the programs used to create the Mac OS X 
desktop and windows, known collectively as Aqua, are 
not available for free and are only distributed as 
compiled applications. 


Shell Commands 


The original computers that ran Unix were not 
graphical; windows, drop-down menus, desktops, and 
the point-and-click capabilities of the mouse were to 
come later. Early versions of Unix were entirely text- 
based, taking input solely from the keyboard and 
displaying only on the screen, or sometimes just on a 
printer. This meant that all Unix programs were text- 
based, and responded to keystrokes. Users accessed the 
operating system through commands given to an 
application called a shell. 


The Unix operating systems of today can handle 
graphics with ease, but underneath the graphical 
windows, text still reigns supreme. Your Mac OS X 
computer is no exception. In Mac OS X, you enter shell 
commands through an application named Terminal. 
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Aqua 


Each time you run Mac OS X on your computer, you are 
using Aqua. Aqua is the graphical user interface system 
that gives your Macintosh the distinctive look and feel 
of Mac OS X — the main menu at the top, the Dock, 
the desktop, the three colored buttons at the upper left 
corner of each window. The Aqua interface lets you 
point-and-click to run applications. In truth, Aqua is a 
group of applications that run atop the Mac OS X 
foundation of Unix; Aqua starts automatically to provide 
you with the familiar Mac OS X interface, designed for 
both keyboard and mouse. 


X Window System 


The X Window System is another graphical user 
interface system that is used on most computers 
running Unix; however, it does not come standard with 
Mac OS X. Although both the X Window System and 
Mac OS X contain the letter X, they are not related — 
the X in X Window System comes from its being a 
successor to an earlier window-based system named W, 
and the X in Mac OS X, of course, stands for the Roman 
numeral ten. 


Because the X Window System is used on so many 
other computers, including Linux, BSD, and Solaris 
machines, there are a number of applications written 
for the X Window System, most of them open source 
and free. You can run X Window System applications on 
your Mac OS X computer by installing an application 
called an X server, which gives you access to a wide 
variety of X Window System software. 


START THE TERMINAL APPLICATION 


enter Unix shell commands and to run Unix 

applications. The name of the Terminal application 
refers back to the physical terminal devices that were 
connected to old Unix mainframes. Each terminal consisted 
of a keyboard for input and a screen for text output. The 
Terminal application provides the same function, allowing 
you to enter your commands through the keyboard and to 
view the output in the Terminal window. 


Y ou can use the Mac OS X Terminal application to 


The Terminal application comes with the Mac OS X operating 
system as a utility application. You can find it in the Utilities 
folder of the Applications folder, by using Finder. Because you 
are using the Terminal application to run the Unix commands 
in this book, you want to keep the Terminal handy by setting 
it to Keep In Dock. This allows you to launch a Terminal 
window from the Dock with a single mouse-click. 


You can have several Terminal windows running at once. 
You can also switch between Terminal windows by using 
the keyboard shortcuts. 


Each Terminal application runs a separate Unix shell. A shell 
is an application that sends your commands to the Unix 
system and provides you with the output of those 
commands. The shell starts by printing a welcome message, 
then provides a prompt and waits for you to type a 
command. The prompt contains the name of your computer 
and your short username, as follows: 


[computer:~] user% 


When a Unix shell command is completed, the prompt 
appears again. As you provide commands to the shell, the 
output of your commands moves down the Terminal 
window. Output that scrolls past the top of the window is 
not lost forever; you can access it by using the scroll bar on 
the right side of the Terminal window, or by using the page- 
up and page-down keys. 


START THE TERMINAL APPLICATION 
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<4 Scroll down until the 
Utilities icon is visible. 


BA Double-click Utilities. 
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The Utilities folder appears 
in a Finder window. 


=3 Scroll down until the 
Terminal icon is visible. 


= Double-click Terminal. 


Mf The Terminal window 
opens, displaying a welcome __ the Dock and hold for two 


message and a prompt. seconds. 
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You can have several Terminal windows running at once. To 
open a new Terminal window, press 38 + N. To switch 
between the Terminal windows, press 3 + < or 3% + ~—. 


If you use the scroll bars to scroll back and then type a 
command, the window snaps back to the current prompt, 
with the result that you can no longer see the scrolled text. 
The version of the Terminal application that comes with 
Mac OS X 10.2, Jaguar, lets you split your Terminal window 
so that you can keep scrolled text on-screen for reference. 


To split the window, click the small icon that looks like a 
broken square in the upper-right corner of the Terminal 
window. A bar appears, separating the window into two 
panes. Each pane has a separate scroll bar, and only the 
lower pane scrolls when you type shell commands. You can 
change the relative sizes of the panes by clicking the 
separator bar and dragging it up or down. 


To return the split windows to only one pane, click the 
square gray icon in the upper-right corner of the lower pane. 
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Keen in Dock 
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KEEPTERMINALINDOCK ss £2 Select Keep In Dock. 


MB Click the Terminal iconin ‘Ml The Terminal icon stays in 


the Dock even after you close 
the Terminal application. 


BA pop-up menu appears. 


CONFIGURE THE TERMINAL APPLICATION 


Terminal application to meet your particular needs. 

For example, you can give each Terminal a different 
name, such as Editing the Config File or Compiling the 
Server, to remind you of what you are doing in that 
Terminal; or, if you find the default font size too hard to 
read, you can enlarge it or change it to a different font. 


6 ou can set the preferences and settings of the 


You can access the Terminal application Preferences panel 
through the Terminal window. This panel allows you to 
change the command shell that executes when you start the 
Terminal application. For more information on using other 
shells, see Chapter 6. 


You can change the appearance of the Terminal window by 
selecting the Window Settings option from the Terminal 
menu. The Terminal Inspector panel appears, allowing you 
to configure the settings for the current window. There are 
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Hide Terminal 
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OPEN THE WINDOW @ The Terminal Inspector 
a EE panel appears. 

LB Click Terminal > Window 

Settings. 


seven groups of settings: Shell, Processes, Emulation, Buffer, 
Display, Color, and Window. You can switch between groups 
by selecting the group name at the top of the Terminal 
Inspector panel. Within each group, you can change a 
number of related settings; for example, the Window 
settings allow you to control the size of the Terminal 
window and the title at the top of the Terminal window. 


Any changes that you make to the Window settings apply 
only to the current window. However, you can set the 
current values as the default for all future Terminal windows 
by clicking the Use Settings as Defaults button. 


You can save your Window settings by selecting the Save, or 
Save As, option from the File menu; this creates a TERM file. 
You can load Window settings from a TERM file by using 
the Open command from the File menu, thus creating a 
new Terminal window with those settings. 
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SET THE WINDOW TITLE EY Click the Use Settings as 


PA Click here to select Defaults button. 


Window from the scroll menu. 
<3 Type a title in the Title field. 


4 Click additional check 
boxes to add the current 
dimensions or process 
name to the title. 


A} Click the upper-left 
button to close the Terminal 
Inspector panel. 


The title of the current 
Terminal window changes. 
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The Shell and Processes settings let you You can change the color of the Terminal window 


determine whether the Terminal window closes and text by using the Color settings. The Window 
when you quit the shell application, and they settings affect the dimensions of the window and 
also help you to avoid accidentally closing the title that appears in the top bar of the Terminal 
windows with active Unix shell commands window. You can set the title to a specific name, or 
running. The Emulation settings allow fine-tuning | to reflect the current size or running commands of 
of input and output controls to better emulate, the Terminal window. 


or mimic, a physical terminal device. The Buffer 
settings control the number of lines that the shell 
saves as scroll back, and which you can access by 
using the scroll bars. 


The Display settings control the appearance of 
the cursor and the text in the Terminal window. 
You can change the font or font size, or you can 
set the text to be anti-aliased. Anti-aliasing uses 
shades of gray to make the text easier to read, 
but it can also slow down the display of Unix 
shell commands. 


[ @ Terminal BBG edit Scrottback Font Window Help 4) Fri 12:00 PM [ & Terminal FEO 
2 © e. _ ig New Sheil %N ae oe RY FART Eee ane ere Sn oooeeees as ts en ae er are eee Pe ee wots ey = cree ey : a ees 2, ’, =~ . 
Last login: Wee New Command... ORN : E) msendnininmettahenenou divin in oe ee 
Welcome to Dare Open... ; 
{ferro:~] user¥ .Litrary : ——= 
H g © BR Desktop 
, £# FontCollections 
ie 3 Fonts 
it Movies i iMovie 
| OB Music ’ * Internet Plug-ins 
: 4 4 Pictures B Keyboard Layouts 
4 GB Public 


| DYsites & Logs 
— & My Terminat Preference. 
‘ [= Preferences 


5 Created: 13 Nov 2002 
Fy Modified: 13 Nov 2002 


{3 Open this file when Terminal starts up 


SAVE THE WINDOW SETTINGS @ The .term extension OPEN ATERM FILE ue4 Click Open. 
fa Click File > Save As. appears as you type. ut) Click File > Open. B A Terminal window opens 


Ey] Click Save to save and : : with a configuration based on 
= 11 
my The: Saeeipanshgppests: close the dialog box. Cave a previclbtyicaten your saved settings. 
Re eeciteounnes @ The Window settings are 
saved in a TERM file with the 


.term extension. 


ENTER UNIX SHELL COMMANDS 


directly at the prompt in the Terminal window. These 

commands allow you to run Unix applications from 
the shell. You can also run commands that tell you the 
current state of your shell commands, such as which 
programs are running or the current location of your 
Terminal shell in the file folder hierarchy. 


Vi can execute Unix shell commands by typing them 


After typing each command, you must press the Return key 
to tell the shell that you are done typing. The shell does not 
run your command until you press Return. This allows you 
to go back and edit the command before the shell runs it. If 
you make a typing mistake, you can use the Delete key to 
back up and erase your mistake, then retype the command 
and press Return. 


If you do not notice your mistake before pressing Return, 
you may get an error message. If you type a non-existent 
command, such as mistake, Unix returns the following: 


mistake: Command not found. 


You can recall your last command by pressing the up-arrow 
key; the exact command you typed appears after the 
prompt. You can edit the line using the Delete key and then 
press Return when you have corrected the mistake. This is 
also a useful way to repeat commands. If you press the up- 
arrow key repeatedly, you can move either back or forward, 
respectively, through all the shell commands you have 
typed. 


The easiest Unix command to type is the w command. This 
command shows you who is connected to your computer 
and how long they have been idle. Old Unix machines often 
had dozens or even hundreds of users connected at once, 
but you see only one line for each Terminal window you 
have open. 


ENTER UNIX SHELL COMMANDS 


Edit Scroliback Font Window Help 


Cy a ee 
Last login: Wed Nov 13 03:42:1@ on ttypl 
Welcome to Darwin! 


3:440M up 3:14, 3 users, load averages: 0.29, 0.29, @.26 
TTY FROM LOGIN@ IDLE WHAT 
12:31AM 3;13 - 
3:44AM @ - 
3:29AM i3_- 
{ferro:~] userx ff 


ENTER THE w COMMAND Type the letter w and press 
1 Open the Terminal Bein. 
application. The shell displays the users 


connected to your computer. 
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sco Terminal — ttyp » ’ 
Last login: Wed Nov 13 93:42:10 on ttypl 

Welcome to Darwin! 

(ferro:~} user% w 

3:444M up 3:14, 3 users, load averages: 0.29, @.29, @.26 

USER TTY FROM LOGIN@ IDLE WHAT 

user co - 12:31AM 

user pi - 3:44AM 

user p2 ~- 3:29AM 

ferroj~] user® 


e: Command not found. 


L[ferro:~} users] ww 
ww: Command not found. 


[ferro:~] user% 


&3] Type ww and press 
Return. 


Type the letter e and press 
Return. 


An error message appears 
because there is no UNIX 
shell command named ww. 


An error message appears 
because there is no UNIX 
shell command named e. 


You enter Unix shell commands through a 
keyboard, and so they are susceptible to 
typographical errors. Fortunately, you can 
set your shell to automatically intercept 
these mistakes and to make a reasonable 
guess at what you are trying to type. This 
helps you to avoid error messages that 
declare that a command cannot be found. 
You activate this function by using the 
set command. To do this, type set correct 
= cmd after the prompt. 


After you have activated the function, 
when you enter a command that does not 
exist, the shell tries to find a match. It 
then asks you to reply by typing a y for 
yes, n for no, e for edit, or a for abort. 
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SG Eee ten 
Last login: Wed Nov 13 03:42:10 on ttyp1 
Welcome to Darwin! 
(ferro:~] user® w 
3:44AM up 3:14, 3 users, load averages: 9.29, 0.29, @.26 
USER TTY FROM LOGIN@ IDLE WHAT 
user co - 12:31AM 3:13 - 
user pl - 3:44AM Qo - 
user p2 - 3; 29AM 13 - 
(ferro:~] user® e 
e: Command not found. 
[ferro:~] user® wo 


we: Command not found. 
[ferro:~] users] ww 


CORRECT A SHELL 
COMMAND ERROR 


E} Press the Up Arrow key. 


The previous command 
appears after the prompt. 


GET STARTED WITH UNIX 


TYPE THIS: 


[darwin:~] user% ww 


RESULT: 


CORRECT>w (y|njela)? yes 

4:16AM up 3:46, 2 users, load averages: 0.78, 0.80, 0.68 
USER TTY FROM LOGING IDLE WHAT 

user co - 4:01AM 3:45 - 

user pl - 3:53AM 0 - 
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Last login: Wed Nov 13 93:42:10 on ttypl 
Welcome to Darwin! 

(ferro:~] user® w 

3:444M up 3:14, 3 users, load averages: @.29, 0.29, 0.26 
USER TTY FROM IDLE WHAT 
user co - 3:13 - 
user pi - g Q - 
user p2 - : 413 - 
(ferro:~] user® e 

e: Command not found. 

[ferro:~] user® ww 

ww: Command not found. 


3:45AM up 3:14, 3 users, Load averages: 9.20, @.26, @.25 
LOGIN@ IDLE WHAT 
12:32AM 3:14 - 
3:44AM @ - 
3:29AM 13 - 


ferro:~j] user’ 


Press Return. 


The shell executes the w 
command. 


A2]] Press the Delete key to 
delete the second w. 


SHELL COMMAND CONCEPTS 


strung together, apparently at random. To the 
uninitiated, they can appear arbitrary, but there are 
some general concepts that hold them together. 


S hell commands in Unix are often cryptic sets of letters 


Shell commands execute as soon as you type them and 
press the Return key. The execution consists of two steps: 


ANATOMY OF A SHELL COMMAND 


First, the shell interprets the command line you have typed 
and breaks it down into its constituent parts. Second, the 
shell uses those parts to determine whether a built-in 
command or an executable program should be run, and 
then passes the appropriate parameters to the command or 
executable program. 


Each shell command is composed of specific parts, including 
the command name, options, and arguments. These parts 
tell the shell which command to execute, how that 
command should be executed, and what other information 
on your computer it should use in the execution of the 
command. You can better understand how Unix reads shell 
commands by looking at the following example: 


Simple Command Name 


The shell breaks down your command into words 
separated by spaces, and then interprets the commands 
one word at a time. The first word in the above 
command is grep, and so, the shell knows to execute 
the grep command. 


To save on typing, Unix commands have traditionally 
been very short words. Some are not even 
pronounceable words in English, such as the 1s, cd, rm, 
or pwd commands. The word grep can be pronounced, 
but it seems to have no meaning in English. This is 
because it is actually an acronym for global regular 
expression print. That may not help you much, but for 
now, it is enough to say that the grep command lets 
you search for text in a file. 


Options 
You can type a number of options after the command 
name; these are strings starting with a hyphen or dash, 
for example -i. You use these options to force Unix 
commands to change their behavior. Each command has 
a unique set of options that you can use with it, and the 
meanings of these options vary from command to 
command. For example, with grep the option -i means 
to match text without regard for letter case, while with 
rm — a command that deletes files — the option -i tells 
the shell to ask the user to confirm each file deletion. 


Many options are single letters, but some are a single 
letter and then a value, such as -C2, which stands for 
the option -c and the numeric value 2. Longer options 
are often set off with two hyphens, as in --line-number. 


grep -i -C2 --line-number "Mac OS X" 


Documents/to-do.txt 


This command illustrates all of the components that 
comprise a shell command, and illustrates how to use 
multiword arguments by employing quotes. 


Arguments 


After the options in the command line, you can add 
arguments in the form of filenames or text. The 

shell command passes these arguments along to the 
command that you are executing, and they give 

the command such information as what file or 
information to look for, or where to store the results of 
the command when it is done. In the example above, 
the grep command has two arguments: "Mac OS X" 
and Document s/to-do.txt. The first argument to the 
grep command, "Mac OS X", isa specific piece of text 
that you want to find in a file, and the second argument, 
Documents/to-do.txt, is the name of that file. 


Escaping Arguments 


The quotation marks around the three words "Mac OS 
X" tell the shell to treat them as one argument rather 
than three. If the quotation marks are not used, the 
command line tells the grep command to look for the 
word Mac in files named OS, X, and Documents/to- 
do.txt. You can use quotation marks whenever you 
need to include multiword arguments or filenames in 
your Unix commands. Or, you can type a backslash (\) 
before each space; this tells the shell not to treat the 
following space as a word separator. 


USING SHELL COMMANDS 


Executable Files 


Most commands that you enter on the command line are 
requests to run a program of some kind. The command 
may be a compiled program originally written in a 
language such as C++ and now saved on disk as a binary 
file. It may be a script written in Perl, or it may be a shell 
script. To be run, a file must be executable. Executable 
refers to both the contents and the attributes of a file. 


Built-In Commands 


Some of the commands you type are built directly into 
the shell application and do not exist as separate files. 
These functions include starting and stopping 
commands, setting shell variables, repeating commands, 
and moving through the file structure. 


You can get a full list of the built-in shell commands by 
typing the command builtins at the shell prompt. One 
built-in command that is quite useful is the which 
command. The which command tells you whether a 
command is a built-in command or an executable file; 
if it is an executable file, the shell lists the location of 
that file. 


GET STARTED WITH UNIX 


The shell locates the executable by searching through a 
set of locations on your hard drive called your path. The 
path is a list of folders, also called directories. If you type 
the name of an executable within one of those folders 
and press Return, you are running that file as a shell 
application. By default, your path contains a reasonable 
set of directories, but you can add other file locations. 


which Command 


You use the which command to determine whether a 
command is built-in or is an executable file. 


Vv 


RESULT: 


/usr/bin/w 


You can see from this output that w is an 
executable file stored in the location /usr/bin/w. 


AYER THIS: 


[darwin:~] user’ which which 


Ww 
RESULT: 
which: shell built-in command. 


This output tells you that the which command is 
built directly into the shell application. 


READ THE UNIX MANUAL 


ou can read the Unix manual pages by using the man 

command. These pages give you a basic summary of 

how to use a specific Unix command as well as 
detailed information on the types of parameters you can 
use with that command. 


The simplest way to get information about a given 
command is to type man commandname. If there is such a 
command and if there is a manual page for that command, 
the shell displays the manual page. Because most manual 
pages are long, only the first screen of information displays 
in your Terminal window; to continue on to the next screen, 
you can press the Spacebar. You can continue pressing the 
Spacebar for each screen of information until you have read 
the entire manual page. 


’ A manual page first lists the name of the command, and in 
parentheses, the section number of the manual where you 
can find that command. Some commands or terms appear 


READ THE UNIX MANUAL 


a Terminal File Edit Scroflback font Window Help 
eee / Terminal — typ} 
Last login: Wed Nov 13 @3:44:11 on ttypi 
Welcome to Darwin! 
{ferro:~] users } 


TYPE THE MAN COMMAND 


r4| Type the name of a 
command and press Return. 


La At the Terminal window 
prompt, type man and a 
space. 


in several sections, and you can select from among them by 
including the section number before the term. After the _ 
name of the command, a synopsis of the syntax for the 
command appears. Parameters in brackets are optional, but 
if you use them, you must replace the underlined words 
with an appropriate value or filename when you type the 
command. 


A manual page also includes a description of the command 
and often provides examples of how you can use it. Related 
commands also appear along with section numbers, and 
any files that relate to the command, such as configuration 
files, are shown. Extra bits of trivia, such as the history of 
the command or known bugs, may also appear. 
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HWCL) System General Commands Manual 


- 
w ~ who present users are and what they are doing j 
SYNOPSIS : 
w [-hin} [-M core] [-N system] [user] i 


DESCRIPTION 
The w utility prints a summary of the current activity on the system, 
including whet each user is doing. The first line displays the current 
time of day, how long the system has been running, the number of users 
logged into the system, and the load averages, The load average numbers 
give the number of jobs in the run queue averaged over 1, S and 15 min- 
utes, 


The fields output are the user's Login name, the name of the terminal the jf 
user is on, the host from which the user is logged in, the time the user 
logged on, the time since the user Last typed anything, and the nome and 
arguments of the current process. 


The options are as follows: 


-h —_—_—s Suppress the heading. 


The shell displays the first 
screen of the manual page. 


This area displays the 
Command syntax summary. 


This area displays the 
name and section. 


This area displays the 
Description of the command. 


E] Press the Spacebar. 


> om 


GET STARTED WITH UNIX 


it is quite common for Unix computers to ship without a_ | You can become familiar with the man 
printed manual explaining the Unix shell commands, command by trying some of the commands. 
and your Mac OS X computer is no exception. Decades 

of Unix users have relied upon the man command for Example: 

instructions on the proper use of Unix commands. As (darwin:~] users man 

heir to their legacy, you may sometimes find yourself [darwin:~] user’ abr open 
consulting the manual pages to decipher obscure error [darwin:~] user whatis 

messages. Therefore, you should be familiar with how to | [darwin:~] user% ee 

use the man command. ([darwin:~] users teshb 

Some of the resulting man pages can be 
very opaque; so do not worry about 
anything you cannot immediately 
understand. For example, the man page 
for tcsh is extremely long. 


You will find that only reading a manual page is not 
enough; you also need to understand what it is trying to 
tell you. This can be difficult, as most manual pages 
seem complex at first glance, having been written for a 
very technical audience of Unix system administrators. 
The key to understanding manual pages is to read 
enough of them so that you begin to absorb the 
concepts through familiarity. Use keyword searches and 
look up related commands and terms that you do not 
understand. Reading manual pages requires practice, 
but it is worth the effort. 
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eS | 809 ce ARORA CD 
can be found, w prints “*~'',} : (ferro: 


The CPU time is only an estimate, in particular, if someone leaves a q pos 
background process running after logging out, the person currently on ; man{1) farmat and display the on-line manual pages 
that terminal is ~‘charged'’ with the time, i perlxs(1) s-1XS$s@ Language reference manual 

: raute(8) - manually manipulate the routing tables 
Background processes are not showm, even though they account for much of | manually manipulate the IPsec SA/SP database 
the laad on the system. : p | 


Sometimes processes, typically those in the background, are printed with 
null or garbaged arguments. In these cases, the name of the command is 
printed in parentheses, 


The w utility does not know about the new conventions for detection of 
background jobs. It will sometimes find a background job instead of the 
right one. 


COMPATIBILITY 
The -f, -1, -s, and -w flags are no longer supported. 


HISTORY 
The command appeared in UNIX 3,0. 


i’ 
4th Berkeley Distribution June 6, 1993 4th Berkeley Distribution (5 


{iferro:~J user% i 


i The second screen of @ You have now read the SEARCH THE MANUAL The shell lists commands 
information appears. entire manual page for that By KE wORD related to the keyword. 
term. jf 
Z¥ Press the Spacebar and Type man -k and a space. Press the Spacebar to read 
read each screen until you Type a keyword and press __the list until you see the shell 
see the shell prompt. Return. prompt. 
awe 


en 13 | 


EXIT THE TERMINAL WINDOW 


hen you are done typing Unix shell commands, you 

can exit your shell and close the Terminal window, 

or exit the Terminal application. To do this, you can 
simply click the red Close button in the upper left-hand 
corner of each Terminal window. Alternatively, you can 
choose Close Window from the Window menu or Quit 
Terminal from the Terminal menu. However, these are not 
necessarily the best ways to shut down a shell window. 


This is because Unix shell commands can often continue to 
run in a Terminal window even if they do not appear on the 
screen, or seem to be doing nothing. When you close the 
window, you also terminate the shell application that 
started those commands, and as a result, you often 
terminate the commands as well. 


Ri LN LR A 
al — ttypt 


x: 
{ferro: 

[ferra: 

(ferro: 

[ferno: 

{ferro 


fi ces 


ogou 
[Process completed] 


EXIT FROM THE SHELL 


LB Type exit in the Terminal 
window. 


8 The Terminal window 
closes. 


The shell terminates. 


4 Click the red Close button. 
COMMANDS ARE RUNNING 


For this reason, it is best to use the exit command to end 
a shell in a Terminal window. The exit command ends the 
shell, but leaves the Terminal open. After you quit the shell, 
you can close the window manually by clicking the red 
Close button in the upper left-hand corner of the Terminal 
window. You can change this behavior in the Window 
settings for Terminal by setting the windows to close 
automatically when the shell ends. 


If you close a Terminal window without exiting the shell, 
you probably do not do any serious harm if no shell 
commands are running. The Terminal application tries to 
prevent problems by warning you if you close a window 
that contains a running command. You can choose to 
continue closing the window, or cancel the window closure. 
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Close Window 


Closing this window will terminate the following 
processes inside it: login. tcsh, top 


Load Avg: ‘ 
SharedLibs: ni 
MemRegions: nt 


PhysMem: 24.8 “=r 


VM: «761M + 3; pcg remit 


PID COMMAND ‘osasonconetenemenmoiesie oo eeepiteronmem: . remnerarececennccneementotme vimana E 
705 top 292K «= 48 OK 
704 tcsh 556K 784K 
783 login 344K 572K 
686 Preview 7.134 4.35M 
541 Terminal 13.24 9.87 
404 Lookupd 480K = 828K 
365 Finder 14,.5M 8.27 
364 SystemUISe 426 2.278 
361 Dock 8,384 4,71M 
358 pbs 796K =1.11M 
352 DirectaryS 3.18M 3.08M 
339 cron 292K =: 144K 
337 cupsd 436K 396K 
334 inetd 272K 116K 
321 ntpd 448K = 264K 
_ 317 loginwindo 7.16M 3.42M 


w 


sessssssssostseoon 
RIRFRRRRAKRRRAWK 


SSESESSESESYSESESS 
FRPP RP HEWNHNRRN BP ee 
Toca me OUD MN © 


iy 


ABORT WINDOW CLOSURE WHEN A warning tells you that 


there are commands running. 
@ A command such as top 
is currently running. 


uf} Click the red Close 
button. 


3) Click Cancel to stop the 
window from closing. 


The Terminal window 
remains open. 


The Terminal application 
maintains a list of commands that 
it terminates if you close a 
Terminal window while those 
commands are running. Those 
commands are rlogin, slogin, 
telnet, and ssh. Each of these is 
an application that lets you 
connect to another computer and 
run commands as if you were 
sitting at that computer. 


GET STARTED WITH UNIX 


You can add or remove applications from the list of 
commands that the Terminal application automatically 
terminates when you close a window in the Terminal 
Inspector window; the list is found in the Processes group 
of settings. Click the name of the application and then click 
the Remove button. If you need to add an application to the 
list, simply click Add and type the name of the application. 
Be sure to click Use Settings as Defaults to save your 
Window settings. You can also set the Terminal application 
to prompt you each time you attempt to close a window 
without typing exit first; or you can set it to never ask you. If 
you often connect to another computer via telnet or ssh — 
secure shell — you may want to remove those applications 
from the list to avoid accidentally disconnecting. 
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Processes: 33 a: <a 
Load Avg: 0.4  {gagimmmmm’) | Close Window — ‘ 
Sharedlibs: nt: Closing this window wili terminate the following -- Edit 
MemRegions: nj processes inside it: login, tcsh. top. _ ped 
PhysMem: 24. —_ SSEE : 23 
WM: 762M + 3, Cancel i 
3 ms + 
PID COMMAND \enntepsnsinstetemeeneetieteenes nieve iicioviencnndintailiomenneadenet E 
795 top 5.0% @:04.07 1 4 17) «184K 292K A'EK 
704 tcsh 0.0% 0:08.05 1 t] 15 34@K S5S6K 780K 
763 login 0.0% 6:81.45 1 2 33 2A4KK 344K «572K 
686 Preview @.0% 0:01.57 1 5 92 1.346 7.134 4.35M 
541 Terminal 28.3% 1:18.21 4 B90 231 «2.58M 13.24 9.88M 
484 lookupd 0.0% 0:02.06 2 5S 49 352K 480K 8 3828K 
365 Finder 0.9% 0:33.31 2 BS 135) 3.274 14.5M 8.33M 
364 SystemllISe @.8% 0:01.72 i ’3 84 792K~ 3.42M 2. 
361 Dock 0.4% @:19.43 2 PS | 119 «1.344 8.384 4.71M 
358 pbs 0.0% 0:01.91 2 7 27 «488K = 796K So1..11M 
352 DirectoryS @0.@% 6:01.41 3 B46} 135) «= 78K «= 3.18M 3. 88M 
339 cron @.@% 0:00.67 1 8 15 76K 0 292K: 14 BK 
337 cupsd 0.0% 0:01.87 1 8 22 252K 49436K = - 396K 
334 inetd 0.0% 0:00.01 1 & 12 44K 272K 116K 
321 ntpd 0.@% 0:01.85 1 8 14 104K 448K 264K 
1 317 leginwindo @.@% @:04.87 4 186 | 117 1.76M 7.16M 3.42M 


TERMINATE RUNNING 
COMMANDS AND CLOSE 
THE WINDOW 


@ A command such as top 
is currently running. 


iM Click the red Close 


button. 
closes. 


A warning tells you that 
there are commands running. 


¥4) Click Terminate to close 
the window and end all of the 
commands for this window. 


B® The Terminal window 


Scroliback Font 


Terminal Window Help 


File Edit 


Preferences... 
Window Settings... 


THY: fdev/ttyp1 
Shell: tcsh 


: 
i 
Hide Terminat 3H i 
Hide Others é 
: 


Show All 


When the shell exits: 
©) Don'dclose the window 
3 Closd only if the shetl exited cleanly 


Quit Terminal 


CONFIGURE TERMINAL TO 
CLOSE WINDOWS WHEN 
YOU EXIT THE SHELL 


In a new Terminal 
window, click Terminal > 
Window Settings. 


Click Shell from the 


closes. 


window radio button. 


@ The Terminal window 


gf SHINS SR eee mi 


ZY To apply this configuration 
to all Terminal windows, click 
Use Settings as Defaults. 


Ky Click the red Close button 
to close the Terminal window. 


LIST FILES 


hen you are working in the Unix shell, everything 
W is represented by a file within the file-based 

structure. The file structure is composed of 
directories, which are special types of files that can contain 
other files, including other directories. The commands you 
type are files as well — called executable files — with the 
exception of those commands built directly into the shell 
application. In fact, your shell itself is an executable file. 


If you are familiar with the Mac OS X operating system, you 
are also familiar with the file-structure concept — everything 
is stored in folders. The folders of the Aqua interface are the 
directories of the shell interface — folders and directories are 
interchangeable terms. The term directory has it roots in Unix, 
while the word folder comes from the Mac OS graphical 
interface lineage. 


Each file within a directory has a unique name. These names 
can contain letters, numbers, symbols, and even spaces, 
meaning you can have multiword filenames. However, if 
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your filename contains spaces or punctuation symbols 
beyond a period, underscore, or dash, you need to place 
quotation marks around that filename when you specify it 
in a shell command. 


When you open a Terminal window, your shell opens in a 
specific directory known as your Home directory. This is 
unique to each user on your computer, and Unix uses your 
Home directory to store the files, which you create using 
the various programs you run. 


The command 1s shows you the contents of the current 
directory in which you are working. You can use the option 
-F after the 1s command to add an additional marker to 
indicate each type of file. A forward slash (/) after a 
filename indicates a directory and an asterisk (*) indicates 
an executable file. 
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Pictures 
Public 
Note To Mom.doc Sites 


Movies 
Documents Music 
Librery 
{ferro:~] user% 


cute-puppy . Jpg 
my~dog. jpg 
to-do. txt 


SHOW FILE LIST v4 Type Is and press Return. 


LB Open a Terminal window. The shell displays a list of 


files. 


Documents/ 
Library/ 


LIST FILES WITH FILE TYPE 


Return. 


[ferro:~] user%& ts 
Movies Pictures 
Music Public 
Note To Mom.doc 


cute~-puppy. jpg 
my~dog. jpg 
to-do.txt 


cute-puppy. }pg 
my-dog. jpg 
Note To Mom. doc to-do.txt 


{ferra:~j] user® 


The shell displays a list of 
files. 


LB Type Is -F and press 


A forward slash indicates a 
directory. 


eS. Ss . Sa 


WORK WITH FILES 


HOW HIDDEN FILES 


ou can use the -A option with the 1s command to 

list hidden files. Computers do not always display 

all files to the user. They do not do this to deceive 
you, but rather to help reduce the visual clutter in file 
listings. Hidden files are usually special files, set apart 
from the files that Unix users create and update. They 
may be configuration files or files that establish your shell 
environment. However, there are times that you may need 
to see a listing of all of your files, both hidden and normal, 
while working with Unix. 


Unix hides files by giving them a filename starting with a 
period (.). Most commands, including the 1s command, 
ignore these files. You cannot see them in a normal file 
listing. They also do not appear in the Mac OS X Finder. 
However, you can list them along with the visible files by 
using the 1s -A command. 
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.CFUserTextincoding Documents Pictures 
.DS_Store Library Public 
.Trash Movies Sites 
.ssh Music 

Desktop Note To Mom.doc 


.DS_Store* Library/ Public/ 
»Trash/ Movies/ Sites/ 

~5sh/ Music/ my~dog. jpg 
Note To Mom. doc to-do, txt 


BE Type Is -A and press Z4 Type Is -A -F and press 


Return. Return. 


The shell displays hidden f The shell identifies the 
files. directories with a forward 
slash. 


You can make it more obvious which files are directories 

by combining the -A option with the -F option. When you 
type the command 1s -A -F to get a listing of all files, a 
forward slash (/) appears after each directory name. You can 
also combine these options together and type the 
command as 1s -AF. This command lists hidden files and 
highlights directories at the same time. 


You can run the 1s command with an argument specifying 
the name of a file or directory. If you give a directory 

name, you see a listing of the contents of that directory. If 
the argument is an ordinary file, only the name of the file 
appears. If you specify a filename or directory that does not 
exist, the 1s command tells you that there is no such file or 
directory. 


Ferminat File Edit Scroliback Fant Window Help 
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.DS_Store* Keyboard Layouts/ 
. Localized Keychains/ 
Assistants/ Logs/ 

Audio/ My Terminal Preference.term 
Caches/ Preferences/ 
ColorPickers/ Printers/ 
Favorites/ Screen Sovers/ 
FontCollections/ Saunds/ 

Fonts/ Work Terminal.term 
internet Plug-Ins/ iMovie/ 

[ferro:~] userk 


pgp or rarannentneenenonsvisiumnannernrennareonninning ual 


I The shell displays the 
contents of the Library 
directory, indicating hidden 
files and directories. 


Type Is -AF Library and 
press Return. 


SHOW FILE ATTRIBUTES 


ou can show the attributes of each file, including the 

owner, permissions, and file size, by using the -1 

option with the 1s command. Each file or directory 
has certain attributes that control who owns it and who can 
access it. All files have an owner, who is usually the user 
who created the file. For example, you are the owner of the 
files in your Home directory. You can also associate a file 
with a certain group; groups are collections of users to 
whom you can grant access privileges as a group. 


When you type the 1s -1 command, you see one line for 
each file in the current directory, appearing in columns. The 
first column indicates the file mode; it looks like a series of 
dashes and seemingly random letters such as d, r, w, and x. 
The next column shows the number of other files or 


SHOW FILE ATTRIBUTES 
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34@ Nov 18 15:28 Desktop 
13 @2:0@ Documents 

03:46 Library 
13:49 Movies 
13:49 Music 
15:11 Note To Mom.doc 
13:49 Pictures 
13:49 Public 
13:49 Sites 
15:13 my-dog. jpg 
15:07 to-do.txt 


LIST FILES AND ATTRIBUTES 


The file mode lists the file 


Be Type Is -I and press peripissions: 

Return. The references count is the 
Ml The shell displays the file number of links to the file. 
attributes. 


directories that reference that file. These references, also 
called links, include the directory containing the file itself, 
so each file has at least one reference. For directories, the 
reference represents the number of files within each 
directory. The third and fourth columns show the user and 
group associated with the file. The fifth column shows the 
size of the file in characters or bytes. The sixth column 
shows the date and time the file was last modified. The final 
column shows the name of the file. 


If you want to examine an individual file, you can give the 
filename as an argument to the 1s -1 command. Using the 
ls -1 command on a directory lists the contents of the 
directory, although you can use the -d option to request the 
attributes of the directory without the directory contents. 
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, i eee es a 
{ferro:~] user® ls -1 
total 64 ¢ 
drwx~~~~-~ >20| Desktop 


12 user 
nares 22 user 
3 user 
user 


:@@| Documents 
340] Library 


:11})Note To Mom.doc 
:49] Pictures 
149] Public 


drwxr-xr-x 
drwxr-xe-x 
a ed ae a 
~PWo Rote 


[ferro:~} users ff 


3 
1 
3 
4 
5 
al 
al 


= The time and date of the 
last modification is shown. 


The owner and group 
indicate file ownership. 


= The size of the file is 


# Files are listed in order by 
expressed in bytes. 


filename. 


WORK WITH FILES 


The file mode indicates the file type and permissions. The first 
character is a d for a directory, or a dash for a normal file. The 
other nine letters are read in sets of three. The first set represents 
the permissions for the file owner, the middle set represents access 
by anyone in the file's group, and the last set is for all other users. 


The first letter in each set, r, controls read access for the set of 
users. The second letter, w, controls write access. The last letter, x, 
designates execution access or, for a directory, access to directory 
files. Dashes in the mode field indicate that the corresponding 
permission is not set for the associated set. For example, rw- 
indicates that the users can read and write, but not execute the file. 


Example: 
drwxr-xr-x 5 user staff 170 Nov 4 13:49 Sites 


This directory can be read by the owner, the members of the 
group staff, and anyone else using the computer. Only the 
owner can write to the directory; however, anyone can move from 
directory to this directory. 
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‘[ferro:~] user&[1s -1|my-dog. jpg | 
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DISPLAY FILE ATTRIBUTES The shell displays the file 
attributes. 


SHOW THE ATTRIBUTES 


74 Type a directory name 
OF A DIRECTORY 


1 Type Is -I and a space. and press Return. 


LH Type Is -Id and a space. The shell displays the 


74 Type a filename and press directory atures. 


Return. 


COPY A FILE 


ou can copy files with the cp command. This 
command allows you to save backups of important 


files or keep old versions of files while you edit them. 
Making copies of important files before editing them is a 
good practice because it assures that you can go back to 
the original. 


To copy a file, you supply two arguments to the cp 
command: the first is the name of the original file, and the 
second is the name of the new file. You do not have to own 
the original file to copy it, but you must have permission to 
read it. You also need write permission in the directory to 
where you make the copy. Your cp command should look 
like this: 


cp original-file copy-file 


File Edit Scroliback 


Terminal —- tesh (ttyp1} 


we Ferminal Font Window Help 


If copy-file is an existing directory, the copy will be 
placed in that directory and will be named the same as the 
original-file. 


Copying a file can be dangerous if the file already exists 
with the same name you specify for the copy. In such a 

case, you write over the existing file with the new copy. 
The cp command does not automatically warn you, but 
copies the file, assuming that you want to overwrite the 
existing file. 


To ensure that you do not accidentally write over a file, you 
can use the -i option with the cp command, so that it asks 
you to confirm that you want to write over the existing file. 
If you do, you can type y for yes and press Return; if you do 
not, you can press any key to cancel the process. 


Scroliback Font Window Help 


[ @ Terminal File Edit 
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[ferro:~} user®% 1s -F 


Desktop’ Movies/ Pictures/ my~dog. jpg 
Documents/ Music/ Public/ to-do. txt 
Library/ Note To Mom.doc Sites/ 


: Er®| Cp] my-dog. jpg] cute-puppy. Jpg 
{ferro:~] user® > 


Uj G IOV ‘a 


Pictures/ cute-puppy . Jpg 
Music’ PhbT Yc y-aog- Ip 


Note To Mom.doc Shtes/ to-do. txt 


Documents/ 
Library/ 
(ferro:~] user% ff 


CREATE A COPY 
i Type cp and a space. 


F] Type the name of the copy 
and press Return. 


The shell copies the file. 


Type the name of the 
original file, and a space. 


| 


Movies/ 
Music/ 
Note To Mom.doc 


Pictures/ 
Public’ 
Sites/ 


Desktop/ 
Documents/ 


cute-puppy. jpg 
my~dog. jpg 
to-do.txt 


COPY A FILE SAFELY | Type your response and 


i Type cp -i original-file and pa 


press Return. @ The cp command either 
copies the file or abandons 
the operation, depending on 


your response. 


j The shell asks you if you 
want to write over the file. 


WORK WITH FILES 


DESIGNATE FILES BY PATHNAME 


outside of your current directory when you give a 
filename as an argument to a command such as cp. 
The file system of your Mac OS X computer is set up as a 


VY: can include a pathname to indicate a location 


hierarchy of folders containing files and other folders. Each 
of these folders corresponds to a directory. You can view 
the folders in the Mac OS X Finder application, or access 
them as directories through the Unix shell. 


oo | 


A pathname specifies the place in which you can find a 
file, just as an address tells you where to find someone in 
the physical world. For example, one might describe his 
current location by saying that he is on the planet Earth, 
in the country known as the United States of America, in 
the state of California, in the county of Orange, within 
the city of Fullerton, on Wilshire Avenue, in building 
number 110, on the Garden Level, in suite G-1, in the 
back office, at the desk of Kynn. 


A file, on the other hand, might say that it is on a hard 
drive, in the Users directory, in the kynn subdirectory of 


Relative and Full Pathnames 


The desk of Kynn is in an office that also contains the 
desk of Laura. If you are going to describe the location 
of Laura, you can just say the desk of Laura and not 
spell out everything starting with the planet Earth. This 
is a location relative to the desk belonging to Kynn. In 
the same way, you do not need to specify a full 
pathname if you are already in the same directory. For 
example, if you are working with files in the 
/Users/kynn directory and you want to copy the 
Chapter 02.doc file described above, you do not 

need to type the full pathname, only this: 


[ferro:~] user% cp Documents/"Chapter 
02.doc" backup-ch2.doc 


This creates a copy of the file with the new name 
backup-ch2.doc. Note that this is in the /Users/ 
kynn directory, not in the Documents directory. 


Aliases for Special Pathnames 


Three pathnames refer to special directories. The alias 
dot (.) refers to the current directory in which you are 
working. The alias dot-dot (. .) refers to the parent 
directory — the directory which contains the current 


the Users directory, in the Documents subdirectory of 
the kynn directory, and that it has the filename Chapter 
02.doc. You can write that pathname as /Users/ 
kynn/Documents/"Chapter 02.doc". 


When writing the pathname, you must separate each 
directory name with a forward slash (/). In addition, 
because the filename contains a space, you must enclose 
it in quotation marks to refer to it in Unix. 


The start of the Unix file system is the root directory, 
and you indicate it by an initial forward slash (/). A 
pathname beginning with a forward slash is therefore a 
full pathname, and is relative only to that root directory. 
Starting the pathname with the root directory is like 
starting with the planet Earth when telling someone 
where you are; the root directory corresponds to the 
Macintosh HD icon on your desktop in Finder. You use 
full pathnames to reference files that are outside of the 
directory in which you are currently working. For 
example, to copy a file in the /usr/share/dict directory 
to your own directory, you can type: 


[ferro:~] user% cp /usr/share/dict/ 
propernames name-list.txt 


directory. The alias tilde (~) refers to your Home 
directory, where you store your personal files. If you 
give the name of another user immediately after the 
tilde, then it refers to the Home directory of that user. 


RENAME A FILE 


ou can change the name of a file with the mv 

command. In Aqua, renaming files and moving files 

are two different functions. You move a file in Aqua 
by dragging it to a new location, and you rename it by 
clicking the name field of the file and typing a new name. 
However, within Unix, when you rename a file, you are 
simply moving the file to a new place within the file system; 
even if you are within the same directory, you are moving 
the file to a new name. 


However, if you move a file to another file that already 
exists, you write over that second file. This is not a good 
practice unless you are certain that you want to overwrite 
the second file. 


e Terminal File Edit Scrollback Font Window Help 
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Desktop/ Movies/ Pictures/ cute-puppy. jpg 
Documents/ Music/ Public/ my-dog.jpg 
Library/ Note To Mom.doc _Sites/ to-do. txt 


erro:~] user®|mv| cute-puppy . jpg |big-dog. jpg | 
{ferro:~] user® Ls -F 
Desktop/ Mavies/ 
Document s/ Music/ 
Library/ Note To Mom.doc 
(ferro:~] user® fj 


to-do. txt 


3 Type the new filename and 
press Return. 


Type mv and a space. 


I The shell renames the file. 


74 Type the current filename 
and a space. 


Eee 


RENAME A FILE SAFELY 


To avoid this problem, you can use the -i option with the 
mv command. If moving your file will overwrite another file, 
the shell asks you to confirm that you want to proceed. If 
you do, you can type y for yes, or any other key for no. To 
be safe, you should make a habit of using the -i option 
with the mv command. You can also set up a shell alias to 
automatically use the -i option with the mv command. 


You can use the mv command to move a file from one 
location to another. When you move a file with a command 
such asmv file /directory, the resulting file retains its 
original name, but resides in a different directory. It is only 
when you move a file to both a new location and filename 
that you rename the file. 
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Eee 


(ferro:~] user% ls -F 
Desktop/ Movies/ 
Documents/ Mustc/ 
Library/ Note To Mom.doc 


big-dog. jpg 
my-dog. jpg 
to-do. txt 


Pictures/ 
Public/ 
Sites/ 


)iferro:~] useréjmv -i big-dog.jpg to-do. txt 
[overwrite to-do. txt?]n] 


74 Type your response and 


ul Type mv -i oldname press Return. 


newname and press Return. B® The mv command either 
renames the file or abandons 
the operation, depending on 


your response. 


The shell asks you if you 
want to overwrite the file. 


DELETE A FILE 


ou can use the rm command to delete files you no 
vy longer want to keep. When you delete a file using 

the Mac OS X Finder in Aqua, the Finder does not 
immediately delete the file, but stores it in the Trash. 
However, when you delete a file using the rm command, 
the file completely and instantly disappears. This means that 
if you mistakenly delete a file from the shell, you cannot 
recover it by simply dragging it back out of the Trash. 


As with the cp and mv commands, deleting files can be 
dangerous because people can make mistakes. You can use 
the -i option to tell the rm command to confirm that you 
want to delete a file; if you do, you can type y for yes, and 
press Return. If you do not, you can press any other key or 
simply the Return key. 


WORK WITH FILES 


By default, the rm command only removes ordinary files, 
although you can remove an empty directory with the 
rmdir command; for a directory containing files, you can 
use the rm —r command. You cannot remove directories 
unless they belong to you or you have write permission to 
the files. However, there is no special access permission 
required to delete a file. 


It is possible to delete a file whose name begins with a 
dash, such as - foo or -bar. These are extremely hard to 
remove, because the rm command tries to interpret the 
filenames as an option, because options begin with dashes. 
in this situation, you can use the option -- (a double dash). 
This means that the command does not check the rest of 
the line for more options, making this your last option flag. 
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(ferro: ~~] “user% Is. are 

Desktop/ Movies/ 
Document s/ Music/ 
Library/ Note To Mom.doc 


Pictures/ 
Public/ 
Sites/ 


big-dog. jpg 
my-dog. jpg 
to-do .txt 


{ferro:~] user% ls -F 

Desktop/ Movies/ 
Documents/ Music/ 
Library/ Note To Mom.doc 
| [ferro:~] user® i 


DELETE A FILE 


43 Type the name of the file 
and press Return. 


i The shell deletes the file. 


EM Type rm and a space. 
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ee) 
{ferro: ~] “user® ls -F_ 


Desktop/ Movies/| 
Decuments/ 
Library/ Nate To] Mom. doc 
{ferro:~] user%|rm -i|my-dog. jpg | 
[remove my-dog .jpg?|n| 


[ferro:~] user® 


Pictures/ 
Public’ 
Sites/ 


oy-deg. jpg 
to-do .txt 


DELETE A FILE SAFELY 


EJ Type your response and 
press Return. 


LH Type rm -i and a space. 
@ The rm command either 
deletes the file or abandons 
the operation, depending on 
your response. 


4 Type the name of the file 
and press Return. 


The shell asks you if you 
want to delete the file. 


CHANGE FILE PERMISSIONS 


one set of users by combining these designators together, 
such as go, to indicate users in the file group and users not 
in the file group, while omitting the file owner. 


ou can change the permissions on files you own, 

allowing you to grant or withhold permission to 

others to read, write, or execute your files. There 
are two parameters for the chmod command, the first being 
the new mode, and the second being the file you want to 
change. You specify the mode change by indicating who the 
change affects, whether the change should be to add, 
remove, or set permissions, and what kind of permissions 
you want to set. 


You can mark permission changes with a plus symbol (+) to 
add permissions, a minus symbol (-) to remove them, or an 
equal symbol (=) to set them. The possible permissions are 
the same as those shown by the 1s -1 command: r for 
read access, w for write access, and x for execute access. 


You can make more than one change at a time to a given 
file by listing them with commas as separators. For example, 
to set the file example to be readable, writeable, and 
executable by you, readable and executable by those in the 
file group, and readable by those outside of the group, you 
can type chmod u=rwx,g=rx,o=r example. 


Unix uses letters to designate the users that your mode 
change affects: u, for the owner of the file, or user, g, for 
users in the file group, o, for others — users not in the 
group — or a, for all users. You can designate more than 


Z, 
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sss STIS. Fash ttn} 


drwx------ 28 user staff 68@ Nov 18 15:24 Desktop user 1564 Nov 18 15:42 Desktop 

drwx------ 12 user staff 488 Nov 13 @2:0@ Documents user 408 Nov 13 92:08 Documents 

drwx------ 22 user staff 748 Nov 13 03:48 Library user 748 Nov 13 03:48 Library 

dOrwx-~ ~~~ 3 user staff 102 Nov 4 13:49 Movies user 10Z Nov 4 13:49 Movies 

drwx-~-~-- 3 user staff 102 Nov 4 13:49 Music user 1@2 Nov 4 13:49 Music 

-rw-r--r-- luser staff 6@ Nov 18 15:11 Note To Mom.doc user 6@ Nov 18 15:11 Note To Mom. doc 
user 102 Nov 18 15:42 Pictures 


Orwre + ---2 3 user staff 102 Nov 4 13:49 Pictures 
drwxr~ xr -x j 136 Nov 4 13:49 Public 
drwxr~xr-x 17@ Nov 4 13:49 Sites 
~PWeP eon 25762 Nov 18 15:13 my-dog. jpg 
oP opm Nov 18 15:97 to-do.txt 


user 136 Nov 4 13:49 Public 
178 Nov 4 13:49 Sites 

25762 Nov 18 15:13 my-dog. jpg 

18 15:07 to-do. txt 


107 to-do. txt 


:13 my-dog. jpg 


[ferro:~] user §f 


REMOVE READ ACCESS EH Type the name of a file ADDWRITE ACCESS The shell indicates that 


and press Return. anyone in the file group can 
change this file. 


1 Type chmod g+w and a 


@ The shell indicates that only | space. 
you can read the file. 


LB Type chmod and a space. 


74] Type og-r and a space. = 
4 Type the name of a file 
and press Return. 


a ed 


You can change the permissions 
for an entire directory and its 
contents, including your Home 
directory, by using the —~R option 
with the chmod command. The 
-R option dictates that modes 
should be changed recursively, 
which means that the changes 
apply to all files in that directory 
or in its subdirectories. 


For example, if you want to 
make sure your Home directory 
is readable only by you and not 
by other users of your computer, 
you use the chmod -R 
command. 
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714 Nov 18 15:25 Desktap 

498 Nov 13 02:08 Documents 

748 Nov 13 03:48 Library 

102 Nov 13:49 Movies 

182 Nov 13:49 Music 

6@ Nov 15:11 Note To Mom.doc 

102 Nov 13:49 Pictures 

136 Nov 13:49 Public 

17@ Nov 13:49 Sites 
25762 Nov 15:13 my-dog. jpg 

@ Nov 15:87 to-do.txt 


13:49 Sites 


SET EXECUTION PERMISSIONS 


Ul Type chmod a-x,u+x and a and press Return. 


space. 


4 Type the name of a file 


The shell indicates that only 
you can execute this file. 


{ferro:~] user% chmod -R go-rx ~ 
{ferro:~] user% ls -l 
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Terminal File Edit 


eae 


22 user 
12 user 
22 user 
3 user 
3 user 
1 user 
3 user 
4 user 


748 Nov 
403 Nov 
748 Nov 
102 Nov 
102 Nov 
68 Nov 
182 Nov 
136 Nov 
178 Nov 
25762 Nov 


SET CUSTOM PERMISSIONS 


ui Type chmod a=r and a 
space. 


4] Type the name of a file 
and press Return. 


WORK WITH FILES 


Seraliback Font 


Desktop 
Documents 
Library 
Movies 
Music 
Pictures 
Public 
Sites 


Window Help 


15:27 Desktop 
02:08 Documents 
03:48 Library 
13:49 Movies 
13:49 Music 
15:11 Note To Mom.doc 
13:49 Pictures 
13:49 Public 
13:49 Sites 
15:13 my-dag. jpg 
15:87 ta-do.txt 


18 15: 
"Note To Mom.doc” 


user® Ls -1 "Note 


*. 


The shell indicates the new 
permissions: the file is now 
read-only by everyone. 


Note: You cannot alter this file 
without changing the permissions 


back. 


SELECT FILES USING WILDCARDS 


type out the full name of each file you want to work 

with in Unix. This not only saves typing but also lets 
you refer to multiple files with similar names in a single 
command. 


Y ou can use wildcard characters to avoid having to 


Unix shell wildcards are also called glob-patterns, and the 
use of these wildcards is known as globbing in Unix jargon. 
You can use these wildcards whenever you give a filename 
argument to a shell command. 


The asterisk wildcard (*) matches any sequence of zero or 
more characters in a filename. The question mark (?) matches 
any single character. A range of characters in square brackets, 
such as [a-m], matches any single character within that range. 
Keep in mind that letters in filenames are case-sensitive, so 
while the letter d is a match for [a-m], the letter D is not, 
because it does not come between lowercase a and m. 


A caret (4) at the start of a pattern or a range of characters 
indicates that the pattern should select those characters 
that do not match the given pattern. For example, if you 
want to use the 1s -1 command on all directories and 
files that begin with the letter P, you can type Is -] P*. To 
remove all files beginning with A, followed by three letters, 
and ending in .doc, from your Documents directory, you 
can type rm -i Documents/A???.doc. You should always use 
the -i option with the rm command if you give it wildcard 
arguments, to avoid deleting the wrong files. A careless rm 
* command in the wrong directory can remove the 
contents of the directory. 


Hidden files are resistant to being identified through 
wildcards. The command 1s *, for example, does not list 
them while 1s_. * lists only hidden files. 


SELECT FILES USING WILDCARDS 
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102 Nov 4 13:49 Pictures 
staff 136 Nov 4 13:49 Public 


MATCH A GLOB PATTERN 


F) Type a wildcard pattern 
that matches the files you 
want to select. 


ul Type a command that 
takes a filename as an 


argument. The shell executes your 
command on the files 
specified by the wildcard 


pattern. 
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-ld P* 
3 user] staff] 102 Nov 4 13:49 Pictures 

drwxr-xe-x 4 user} staff] 136 Nov 4 13:49 Public 

staff 816 Nov 18 15:29 Desktop 

staff 408 Nov 13 @2:08 Documents 

staff 748 Nov 13 03:48 Library 

staff 102 Nov 4 13:49 Movies 

staff 102 Nov i 
ted theta adel Shae staff 6@ Nov 
drwxr--r-- staff 178 Nov 
staff 25762 Nov 18 


749 Sites 
313 my-dog. jpg 
787 to-do.txt 


staff @ Nov 18 


USE CARETSTO SELECT 


The shell executes your 
UNMATCHED FILES 


command on the files in the 
current directory, except for 
those specified by the 
wildcard pattern. 


El Type a command that 
takes a filename as an 
argument. 


4 Type 4“ followed by the 
wildcard pattern matching 
the files you do not want to 
select. 


WORK WITH FILES 


SELECT FILES USING COMPLETION 


command completion, which is a special function 

built into the shell. To use filename completion, you 
must type out the first part of the filename and then press 
the Tab key. If there is a file that matches the incomplete 
filename, the shell fills in the full filename for you. 


Y ou Can easily specify filename arguments by using 


If no file matches the filename, your shell program emits a 
beep, indicating that there is not a match. If more than one 
file matches, the shell program fills in as much as it can and 
then emits a beep, while waiting for you to enter more text 
to differentiate between the files that match the pattern up 
to that point and then differ. At this point, you can either 
type out the rest of the command line and press Return, or 
type enough of the command line to uniquely identify the 
file you want to access, and then press Tab again. 


SELECT FILES USING COMPLETION 


To see the results of an ambiguous match, you can press 
Control + D after the beep. Alternatively, you can type set 
autolist, which instructs your shell to list the remaining 
choice whenever file completion fails. This is a good 
command to save in your .tcshrc file, which ensures that this 
feature is set every time you start a Terminal window. 
Similarly, you can turn off autolist with unset autolist. 


You can combine filename completion with full or relative 
pathnames as well; if you type a partial pathname and press 
Tab, the shell lists the options within that path. Using 
filename completion can save you a lot of typing as well as 
making it less likely that you mistype any characters. 


& Yerminal file Edit Scrollback font Window Help 


Terminal — ttyp 


[| Tferro:~] user |set_autolist 
iTferro:~] user%jis -1d]D| 
Desktop/ Documents/ 


[ferro:~] user% Is -1d Df 


<4 Type the first few letters of 
the filename and press the 


Tab key. 


il Type set autolist. 


24 Type a shell command 
that takes a filename as an 
argument. A list of possible matches 


appears. 


Terminal File Edit Seroilback Font Window Help 
: Terminal — ttyp] 


[ferro:~] user® set autolist i 
ferro:~j] user¥ 1s -1d | c 
Desktop/ Decuments/ 
{ferro:~] user® 1s -1d Desktop/| 

6 user staff 204 Nov 18 16:34 Desktop/ 
(ferro:~] user% 


6 | Press Return. 


The shell executes the 
command. 


Type enough letters to 
make an unambiguous 
match. 


FE} Press the Tab key again. 


The shell completes the 
filename. 


FIND FILES BY NAME 


using the £ind command. This command tends to be 

faster than the Mac OS X Sherlock application for 
locating files, especially those that are used by the system 
or otherwise hidden from the Finder. 


Y ou can locate files by their names or other criteria by 


The find command is a complex and very powerful utility 
that lets you run many different types of searches and 
perform a variety of actions on the files that it finds. 
However, the most common use for the find command is 
simply to locate files with a certain name and print out their 
locations. 


The basic syntax for the find command is: 
find pathname -name filename -print 


The first parameter, pathname, is the directory where you 
want to search. The filename is the name of the file for 


which you are looking. The argument -print tells the 
find command to display the location of the file. 


You can also give a wildcard pattern instead of a filename, 
and the find command lists all files that match that 
pattern. When you use wildcard patterns in this way you 
need to enclose them in quotation marks. For example, if 
you save a Word document but you do not keep track of 
what folder you save it in, you can use the find command 
to locate all the .doc files in your Documents directory: 


find ~/Documents -name "*.doc" -print 

This displays a list of all file locations matching the pattern. 
If you want to see a full file listing instead of the relative 
pathname for the files found, you can replace the print 


command with the 1s command. 


FIND FILES BY NAME 


Font Window Help 


@ Terminal File Edit Scrojlback 


e000 


. Terminal ~ tesh (ttyp 3) 
(ferro:~] user® Is -F 
Desktop/ Movies/ Pictures/ to-do. txt 
Documents/ Music/ Public/ 
Library/ Note To Mom.doc  Sites/ 


{ferro:~] user%j find] .] -name] my-dog. jpg 


LOCATE FILES BY NAME | Type -name and a space. 


Rll Type find and a space. £3 Type a filename. 


74 Type the pathname of a 
directory and a space. 


| @ Terminal File Edit Scroflback Font Window Help 
eoe8 Terminal — tcsh (tryp 1) 
(ferro:~] user% 1s -F 
Desktop/ Movies/ 
Bocuments/ Music/ 
Note To Mom.doc 


Pictures/ to-do.txt 
Public/ 


Sites/ 


. “name my-dog. jpg 


@ The shell executes the 
find command and prints 
the file location. 


Type -print and press 
Return. 


WORK WITH FILES 


In addition to searching by name or wildcard pattern, you can also 
search by other qualities of the file, such as the last time the file was 
changed, the owner of the file, or the permissions of the file. You 
control the search with the arguments you include after the pathname 
of the directory. 


ARGUMENT SEARCHES FOR 


Like -name, but matches regardless of case. 

Files modified within a certain number of minutes. 
Files modified within a certain number of days. 
Files that have specific permissions set. 

Files that are an exact size in characters. 


T ¢ Terminal File Edit Scrollback Font Window —Heip : @ Terminal File Edit Scroiiback Font Window Help 
868 — Terminal — tesh (typ) —= aes Terminal — tcsh (typi) 
; erro:~] user’ find . -name °*. jpg” B 


r4| Type the pathname of a 
directory and a space. 


Ll Type a wildcard pattern in 
quotes. 


./Pictures/my-dog. jpg a 


[ferro:~] user% 


J Type -name and a space. Type -print and press The shell executes the 


Return. find command and prints 
the file location for each file 
matching the wildcard 
pattern. 


CHANGE THE CURRENT DIRECTORY 


command. Each shell window operates in a specific 

location within the file structure, and you can view 
this location by typing the pwd command. The pwd 
command is Unix shorthand for print (display) working 
directory. The current working directory is the directory 
from which relative pathnames are computed and the 
default directory in which files are found or saved. 


Y ou can change your current directory by using the cd 


If you type cd alone, it returns you to your Home directory. 


If you provide the cd command with a pathname argument, 


either relative or full, you change to that directory. You can 
change your current directory to any directory that grants 
you execution access permissions. This allows you to 
explore nearly all of the directories on your hard drive, with 
the exception of a few system directories that are 
protected. 


CHANGE THE CURRENT DIRECTORY 


Terminal File Edit Scroiiback Font Window Help 


el | | — 


{ferro:~] user® | 


DETERMINE YOUR CURRENT 


I The shell shows your 
WORKING DIRECTORY 


current location. 
LE Type pwd and press 
Return. 


a ee 


When your current directory changes, your prompt changes 
as well, to reflect the new location. Your prompt displays 
the names of up to three directories above your current 
location, or fewer if you are close to the root directory. 

For example, if you are in the directory /usr/share/ 
tcsh/examples, on a computer named ferro, your prompt 
looks something like this: 


[ferro:share/tcsh/examples] user% 


You can use wildcards and filename completion with the cd 
command; it accepts special directory names such as cd . ., 
to go up one directory level, and cd ~user, to change to 
the Home directory of the user user. You can also use the 
cd - command to return to the last directory in which you 
were working. 


8oo 


(ferro: ay ‘user® pwd 

/Users/user 
i{ferro:~/Library/Preferences] user’ pwd 
| /Users/user/Library/Preferences 
{ferro:~/Library/Preferences] user® cq 
{ferro:/etc/mail] user% Jj 


oe ko) 


CHANGE TO A DIFFERENT 
DIRECTORY 


EJ Type a new directory 
name and press Return. 


Type ed and a space. Your current directory 


changes to the new location. 


| @& Terminal file Edit Scrojiback Font Window Help 
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WORK WITH DIRECTORIES 


You can move through the file system by using the 
directory stack. The stack is a list of directories of which 
the shell keeps track. You can list the stack by typing dirs. 


To change to a new directory and add it to the directory 
stack, use the command pushd pathname. This 
command adds a new pathname to the stack, and prints 
the stack. You can use the directory stack by typing popd 
to remove the top directory from the stack and change 
to the next one down, or by typing pushd — with no 
arguments — to swap the top two stack entries and 
change to the new top directory. The directory stack is 
very useful if you are going to be switching between 
several directories in the same shell window. 


Example: 

{ferro:~/Documents] user% pushd /usr/lib 
/usr/lib ~/Documents 

{ferro:/usr/lib] kynn% pushd /etc 

/etc /usr/lib ~/Documents 

{ferro:/etc] kynn%® popd 

/usr/lib ~/Documents 

{ferro:/usr/lib] kynn% 


(ferro:~] user® pwd 

/Users/user 

(ferro:-] user® cd Library/Preferences/ 
(ferro:~/Library/Preferences] user® pwd 
/Users/user/Library/Preferences 


| @° Terminal file Edit Scrollback font Window Help 
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[ferro:~/Library/Preferences] user® pwd 
/Users/user/Library/Preferences 
erro:~/Library/Preferentes] user% 


| Lferro:~] user® pwd 
/Users/user 


(ferro:~/Library/Preferences] user% cd /etc/mail : {ferro:~] user® 


[ferro:/etc/mail] user% 


‘ferro:~/Library/Preferences | | 


RETURN TO THE 
PREVIOUS DIRECTORY 


4 Repeat steps 2 and 3 to 
move to a new directory. 


3 Type cd - and press Return, | RETURNTO YOUR 
HOME DIRECTORY 


Your current directory 
changes back to the previous Type cd and press Return. 


directory. 


Your current directory 
changes to your Home 
directory. 


CREATE A DIRECTORY 


directories. Directories are useful for organizing your 

files into a logical structure. When you create a 
directory in the Unix shell, you can access it through the 
Mac OS X Finder as a folder; conversely, when you create a 
folder in the Mac OS X Finder, you can access it as a 
directory in the Unix shell. 


Y ou can use the mkdir command to create new 


The arguments that you give to the mkdir command affect 
how the command creates new directories. When you 
create a directory with a space in the name, you must 
enclose it in quotation marks, unless you want to create 
several directories at once. 


To create a directory, you need to have write permissions 
for the current directory or the directory in which you are 
creating the new directory. For example, if you want to 


create the directory /usr/local/resp, you must have write 
access to the /usr/local directory. You can either change 
your working directory to the /usr/local directory using the 
cd command and type mkdir resp, or you can type mkdir 
/usr/local/resp from any current directory. 


When you give a pathname, whether relative or full, the 
intervening directories must exist. If they do not, you 
receive an error message, and the directory is not created. 
You can tell the mkdir command to create any necessary 
directories by using the -p option. For example, to create 
the directory ~/Documents/by-date/2003/03, you can type 
mkdir -p ~/Documents/by-date/2003/03. This command 
creates the by-date and 2003 directories as well as the 03 
directory if they do not already exist — presumably, the 
Documents directory already exists in your Home directory. 


CREATE A DIRECTORY 


@ Terminal File Edit Scrollback Font Window Help 
8 Oo. 


= I. ae. 


{ferro:~] user® ls -F 
Desktop/ Movies/ Pictures/ 
Documents/ Music/ Public/ 
Library/ Note To Mom.doc Sites/ 


my-dog. jpg 
to-do. txt 


Sites/ 
my-dog. jpg 
to-do.txt 


Movies/ 
Documents/ Music/ 
[ferro:~] user% J 


CREATE A DIRECTORY 74 Type the name of a new 


Ul] Type mkdir and a space. directory and press Return. 


The shell creates the new 
directory. 


DIRECTORIES AT ONCE 


@& Terminal File Edit Scroilback Font Window Help 


| 


Note To Mom.doc Sites/ 
Pictures/ my-dog. jpg 
Public/ to~-do.txt 


Books/ Library/ 
Desktop/ Movies/ 
Documents/ 


Pictures/ Sites/ 

Public/ my-dog. }pg 
Documents/ to-do.txt 
Library/ 


{ferro:~] user% jj 


Note To|Mom.doc 


CREATE SEVERAL 73% Type the names of several 


directories you want to create 


1 Type mkdir and a space. and press Return. 


The shell creates the new 
directories. 


oe ESS SSS... Saas 


File €dit Scroliback Font 


@  Terminat 


Terminal ~— ttypi 


Window Help 


WORK WITH DIRECTORIES 


By default, anyone on the system can read and 
execute any directories you create, which means 
that all users of your computer can change to the 
new directories and list their contents. If you do not 
want universal access to your files or directories, you 
can change the directory permissions by using the 
chmod command, or you can instruct the mkdir 
command to set the file mode automatically by 
using the -m option. 


When using the -m option, you follow it with the file 
mode you want to set, as with the chmod command. 


Example: 

[ferro:~] user% mkdir -m go-rwx Private 

[ferro:~] user% ls -lad Private 

drwx—— 2 user staff 68 Nov 20 17:03 Private 


@ Terminal file Edit Scroliback Font Window Help 
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Books/ Magazines/ Pictures/ 
Desktop/ Movies/ Public/ 
Documents / Music/ Recipes/ 
Library/ Note To Mom.doc  Shows/ 


Class Assignments/ 


Note To Mom. dec 
Documents/ Pictures/ 
Library/ Public/ 

Magazines/ Recipes/ 
[ferro:~] user% §f 


to-do, txt 


(ferro:~] user® cd Books 


Sites/ user® 1s -F 
my-dog. jpg 
to-do. txt (ferro:~/800ks} user% 1s -F 


Unix for Mac/ 


03/ 


CREATE A DIRECTORY WITH PA Type the name of your CREATE INTERVENING 
A MULTIWORD NAME new directory in quotation DIRECTORIES 
Type mkdir and a space. marks, and press Return. LB Type mkdir -p and a 


The shell creates the new 


space. 


directory. 


[ferro:~/Books} user% cd "Unix For Mac” 
[ferro:~/Books/Unix For Mac] user® 1s -F 


users "Unix for Mac"/Chapters/@3 


Shows/ Chapters/ 
Sites/ [ferro:~/Books/Unix For Mac] user% cd Chapters 
my-dog. jpg (ferro:~/Books/Unix For Mac/Chopters] user% 1s ~F 


(ferro:~/Books/Unix For Mac/Chapters] user% cd @3 
[ferro:Unix For Mac/Chapters/@3] user% ls -F 


/Users/user/Books/Unix for Mac/Chapters/@3 
{ferro:Unix For Mac/Chapters/@3}] users 


4 Type the pathname of 
your new directory, including 
intervening directories, which 
do not yet exist. 


The shell creates the new 


directories. 


DELETE A DIRECTORY 


ou can remove unwanted directories by using the 

xmdir command. One use for this command is to 

remove extraneous directories that make it harder to 
locate files you actually need. 


While you can use the rm command to delete normal files, 
you cannot use it to delete directories. This is a safety 
measure to prevent you from accidentally deleting a 
directory that might contain useful or important files. To 
delete a directory, you must use the rmdir command. 


The argument given to the rmdir command is the name of 
the directory, or directories, that you want to remove. If that 
directory is empty, then the command removes it. If the 
directory is not empty, then a message appears, stating that 
you cannot remove the directory. 


In such a case, you can go into the directory and remove 
any existing files using the xm command, or any 


subdirectories using the rmdir command. You can now 
remove the directory. Sometimes apparently empty 
directories contain hidden files — such as .DS_Store, which 
is a Mac OS X system file — and you need to locate them 
with the 1s -A command and remove them before 
removing the directory. 


While you are not allowed to remove the current directory 
using the rmdir command, you may be able to remove it 
indirectly. For example, if you are in the subdirectory foo of 
your Home directory, you can type rmdir ~/foo. However, 
this is not generally a good idea, because you can end up 
stuck in an unresponsive non-directory where you cannot 
even use the 1s command to list the directory contents. 
You can use the cd command, with no arguments, to return 
to your Home directory. 


DELETE A DIRECTORY 


Terminal File Edit Scroiiback font Window Heip 


—— EE 
(ferro:~} user® ls -F 
Books/ Movies/ 
Class Assignments/ Music/ 
Desktop/ Note To Mom.doc 
Documents/ Pictures/ 
Library/ Public/ 
Magazines/ Recipes/ 
[ferro:~] user® ls -F Magazines 

erro:~J userk 
(ferro:~] user® - 
Books/ Movies/ 
Class Assignment s/ Music’ 
Desktop/ Note To Mom. dq 
Documents/ Pictures/ 
Library/ Public’ 
[ferro:~] user% ff 


Shows / 
Sites/ 
tmy~dog. jpg 
to~do. txt 


Recipes/ 
Shows / 
Sites/ 
my-dog. jpg 
to-do.txt 


DELETE A DIRECTORY F Type the name of an 
empty directory and press 


; 
Type rmdir anda space. | pay 


KJ) Type Is -F and press 
Return to see the results. 


mee ee 


Terminal File Edit Scrofiback Font Window Help 


[5 ~) - ee el 
[ferro:~] user® 1s -F 

Books/ Movies/ 

Class Assignments/ Music/ 

Desktop/ Note To Mom.doc 
BDocuments/ Pictures/ 
Library/ Public/ 
(ferro:~] user® rmdir Recipes 

rmdir: Recipes: Directory not empty 


Recipes/ 
Shows / 
Sites/ 
my-dog. jpg 
to-do .txt 


{ferro:~/Recipes] user® ls -F 
almond-milk-~flans html 
boultture-de-grosse-chatr. html 


mushroom-pastries .htm1 


bouliture-de-grosse~chair.html? y 
mushroom-pastries rtm? y 


DELETE A NON-EMPTY 


3 Bt -i * and press 
DIRECTORY 1 eal ne 


= Return. 
ul Type cd, a space, and the 
name of the non-empty 
directory. 


2] Press Return. 


Note: You may want to use the 1s 
command to view the contents of 
the directory before you delete it. 


ZY Type y and press Return 
for each item that you want 
to delete from the directory. 


KJ Type Is -F and press 
Return to confirm that the 
directory is empty. 


@ The directory is empty. 


[ @ Terminat file Edit Scroflback font Window Help 


{ : 

(ferro:~] user® 15 -F 
Books/ 

Class Assignments/ 
Desktop/ 

Documents/ 

Library/ 


Mote To Mom.doc 
Pictures/ 
Public/ 


(ferro:~] user% ls -F 
Books/ Movies/ 

Music/ 

Note To Mom, doc 
Pictures/ 


Public/ 


Class Assignments/ 
Desktop/ 
Documents/ 
Library/ 

{ferro:~] user’ § 


Type cd .. and press 
Return. 


@ Your current directory 
contains the now-empty 
directory. 


Type rmdir and a space. 


emply. 


[3] Type the name of the 
directory and press Return. 


The shell deletes the empty 
directory. 


Note: You may need to find and 
delete hidden files if you see an error 
that says the directory is not yet 


WORK WITH DIRECTORIES 


There is another way to remove an entire directory and its 
contents, hidden or otherwise, using the rm command. The 
-r option instructs the rm command to remove a directory 
and everything within it; the -£ option instructs the rm 
command not to ask you about each deletion. 


Although you can use the rm -xrf command to delete an 
entire directory at once, you should be very careful about 
doing so, as a mistyped command could very easily wipe 
out important files, with no way to recover them. 


Example: 

[ferro:~] user% rm -rf Install/ 
(ferro:~] user% rm -rf ~/ Extra 
{ferro:~] user% ls 


1s: Permission denied 


Note that in the second line above, the user probably 
means to type ~/Extra, but accidentally puts a space before 
the word Extra. This is a costly mistake, as it means that the 
rm command deletes the Home directory of the user. 
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Recipes/ Class Assignments/ Sites/ 


Shows / Desktop/ Note To Mom.doc my-dog. jpg 
Sites/ Documents/ Pictures/ to-do. txt 
my~dog.jpg Library/ Public/ 


to-do. txt (ferro:~] user® 1s -F Shows 
(ferro:~] user%® rmdir Shows 


rmdir: Shows: Directory not empty 


Shows/ 
Sites/ 
my-dog. jpg 
to-do. txt 


[ferro:~/Shows}] user% 


[ferro:~] user%[rmdir Shows| 
(ferro:~] user® ls -F 


Books/ Movies/ Sites/ 
Class Assigrments/ Music’ my-dog. jpg 
Desktop/ Note Fo Mom, dec to-do, txt 
Documents/ Pictures/ 

Library/ Public/ 


(ferro:~] users ff 


DELETE HIDDEN FILES 
PREVENTING DIRECTORY 
DELETION 


4 | Repeat step 3 for each 
hidden file. 


EJ Type cd... to move to the 
parent directory. 


LB Type cd, a space, and the 
name of the directory, and 
press Return. 


| Type rmdir, a space, and 
the name of the directory you 
want to delete. 


74 Type Is -A and press 
Return. 


The shell deletes the 
directory and its contents. 


4 Type rm, a space, and the 
name of a hidden file. 


MOVE FILES INTO A DIRECTORY 


the mv command. This is the same as dragging a file 

in Finder to a new folder location. The mv command 
can rename a directory just as it renames a normal file, but 
it can also move the location of a file or directory within the 
file structure. You can use the mv command to move a file, 
or directory, by typing a command like this: 


Y ou can move files into or out of a directory by using 


mv file location 


The argument location must be a directory. Either this 
directory exists and is owned by you, or you must have 
permission to write files in the directory. If you type the 
name of a directory that does not exist, you will not see an 
error; the file will be renamed to the second name you 
typed. This can also happen if you mistype the name of the 
directory. 


You can move multiple files using the mv command, 
however, they must all go into the same directory. To do 
this, you can simply type out each filename and specify the 
destination as the final argument, as follows: 


mv fileOne fileTwo fileThree andSoOn 
location 


This command moves all of the files that you list to the 
location that you specify. If that location does not exist as a 
directory, an error message appears, and the command 
does not execute. 


Using the -i option with the mv command can prevent you 
from accidentally overwriting files when you move them. 


MOVE FILES INTO A DIRECTORY 
L_&_Terminal | File Edit Scroliback Font Window Help 


YF a Le 
(ferro:~] user® 1s -F 2 
Books/ Movies/ Sites/ 


Class Assignments/ Music/ my-dog. jpg 
Desktop/ Note to Mom,doc to-do. txt 
Documents / Pictures/ 

Library/ Public/ 


(ferro:~] user% {mv ["Note to Mom. doc" Documents |-———— 
Sis _—F Docunents FC 
Note to Mom.doc 


Microsoft User Data/ 
{ferro:~] user¥ 


MOVE A FILE INTO A DIRECTORY 3 Type the name of the 


destination directory and 


1 
# Type mv and a space. press Return. 


Type the name of a file 


and a space. =4 Type Is -F and a space, 


followed by the name of the 
Note: Use quotes around the directory, and press Return. 


filename only if it contains spaces. ni cenellichaweaealein 


the new directory. 
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| S-) 
(ferro:~] user® ls -F 

Books/ Library/ Public’ 

Class Assignments/ Movies/ Sites/ 

Documents/ Pictures/ to-do. txt 


{ferro:~] user% 
[ferro:~] user% 
Microsoft User Data/ my~dog. jpg 
|Note to Mom. doc to-do.txt 
ferro:~] userk § 


MOVE MULTIPLE FILES 4 Type Is -F anda space 
INTO. A DIRECTORY followed by the name of the 
El Type mv and a space. directory, and press Return. 
P4 Type the names of the The shell shows the files in 
files separated by spaces. the new directory. 


EJ Type the name of the 
destination directory and 
press Return. 


ere 


COPY A DIRECTORY 


Y ou can use the cp command to make a copy of a 


directory by using the -R option. Individual files can 

be copied using the cp command with no options, 
and as with the mv command, you can give a list of files and 
a destination directory in order to copy a number of files 
into the same directory: 


cp fileOne fileTwo fileThree andSoOn location 


You can use wildcards to copy files. For example, to copy all 
of your .doc files into your Documents directory, type cp 
*.doc ~/Documents. 


When you copy files into a directory, the new versions of 
each file will be named with their original names. The 
directory needs to exist, as the cp command will not create 
a new directory for you. You can use the mkdir command 
to create the directory first. 
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(ferro:~] user® 1s -F 

Books/ Library/ Public/ 

Class Assignments/ Movies/ Sites/ 

Desktop/ Music/ 

Documents/ Pictures/ 

[ferro:~] user® ls -F Sites 

images / wen.cssinz4hours.com/  waw.unixformac.com/ 
index html www .kynn.com/ 


erro:~] user% “Sites Archive 2002-11-20" 


{ferro:~] user® 


3 Type the name of the new 
copy of the directory and 
press Return. 


ul Type cp -R and a space. 


74 Type the name of the 
original directory and a 
space. 


| 


WORK WITH DIRECTORIES 


However, if you try to copy a directory as you would copy a 
file, you see an error message because directories are not 
normal files: 


[ferro:~] user% cp Documents "Backup of Docs" 
cp: Documents is a directory (not copied). 


To copy a directory, you must use the -R option, which tells 
the cp command to copy the directory and its contents to 
the new location. For example, to create a copy of the 
Documents directory, you can type cp -R Documents 
"Backup of Docs". 


This will copy the entire directory at once, creating the new 
directory and duplicating all of the files. The names of the 
original files will be the same, although the directory names 
will be different. 
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(lS 
(ferro:~] user® 1s -F 
Books/ Music’ 
Class Assignments/ Pictures/ 
Public/ 
Sites/ 


Sites Archive 2002-11-20/ 
{ferro:~] user% 


images/ wew.cssin24hours.com/  wew.unixformac.com/ 
index.html 


is -F "Sites Archive 20@2-11-20" 
wew.cssinZ4hours.com/ = wiv. unixformac. com/ 
www. kynn. com/ 


[ferro:~] user® | 


Type Is -F and a space 
followed by the name of the 
original directory, and press 
Return. 


The new directory is a 
duplicate of the original 
directory. 


Repeat the ls —F 
command in step 4 to show 
the contents of the new 
directory. 


DETERMINE DIRECTORY SIZE 


ou can use the du command to display the size and 

contents of a directory. The name of the du 

command stands for disk usage, and it tells you how 
much space each file or directory uses on your hard drive. 
This information is also available from the Finder using the 
Get Info menu option. When you use the 1s -1 command, 
you see a value for the size of the directory just as you do 
for other files. However, this value does not represent the 
size of the contents of the directory; it represents the size 
of the directory entry itself, a list of the files stored in the 
directory. To obtain the size of the contents of the directory, 
including subdirectories, you can use the du command. 


If you type du alone, you get a listing of disk usage in the 
current working directory; if you give one or more 
arguments, you see the space taken up by each of those 


directories or files. Additionally, the space used by all 
subdirectories also appears, along with subdirectories of 
subdirectories. This can make the output of the du 
command quite extensive and hard to read; if you want a 
single answer to summarize the size of a directory, you can 
use the option -s with the du command. 


When the du command displays sizes for files and 
directories, it measures these sizes in disk blocks; a block 
on a Unix file system disk represents 512 characters. This is 
an easy number for computers to work with but somewhat 
difficult for us humans to grasp. You can use the option -k 
to make the du command list sizes in kilobytes, which are 
units of 1,024 bytes. 


DETERMINE DIRECTORY SIZE 
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a I 


-/Books/Unix for Mac/Chapters/@3 

_/Books/Unix for Mac/Chapters 

-/Books/Unix for Mac 

./Books 

./€lass Assignments 

./Desktop/screenshots/Ch@1/pdf 
./Desktop/screenshots/Ch@1/ti ff 

. Mesktop/screenshots/Che@t 
./Desktop/screenshots/Ch02/pdf 
./Desktop/screenshots/Ch02/ti ff 

. Desktop/screenshots/Che2 
./Desktop/screenshots/wrong resolution 
./Desktop/screenshots 

./Desktop 

./Documents/Microsoft User Data/Entourage Temp 
-/Documents/Microsoft User Data/Office X Identities/Main Identity 
./ODocuments/Microsoft User Data/Office X Identities 
./Documents/Microsoft User Data 


LIST DIRECTORY SIZES The shell displays a list of 


LB Type du and press Return. directory sizes. 


VS oS 2S 297 S28 sc 
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C—O 
./Library/Preferences 
./Library/Printers 
./Library/Screen Savers 

./Library/Sounds 

./Library 

./Movies 

. /Music 

./Pictures 

-/Public/Orop Box 

./Public 

./Sites/images 

./Sites/www.cssin24hours .com 

./Sites/www. kynn.com 

-/Sites/www_unixformac.com 

./Sites I 
./Sites Archive 2@02-11-20/images 

./Sites Archive 2002-11-20/mww.cssin24hours.com 
./Sites Archive 2002-11-20/waw, kynn.com 

./Sites Archive 2002-11-20/www. unixformac.com 
-/Sites Archive 2002-11-20 


oe 


N 
yl 
Ss 
N 
> 


{ferro:~] users ff 


The final number in the list 
is the total disk usage for your 
current directory, in blocks. 


WORK WITH DIRECTORIES 


You can use the df command to check the total disk usage on 
your computer. Like du, df measures sizes in 512-character blocks, 
but you can use the -k option to make the results easier to read. 
The df -k command lists all file systems on your computer, and 
gives you a percentage indicating how full your disk is. 


Example: 

[ferro:~] user% df -k 

Filesystem 1K-blocks Used Avail Capacity Mounted on 
/dev/disk0s5 5865644 4027644 1779344 69% / 
devfs 0 100% /dev 
fdesc 100% /dev 
<volfs> 100% /.vol 
automount -fstab [314] 00% /Network/Servers 
automount -static [314] 100% /automount 


The last five file systems in the above list correspond to internal 
systems used by the Unix operating system. You can safely ignore 
them and only look at the first listing. According to this listing, the 
above computer has a single disk that is 69 percent full. 


File Edit Scroiiback font Window Help 
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/Users/user 


| @ Terminal File Edit Scrofilhack Font Window Help 


Terminal 


TFerro:~] user%|du -s) [ferro:~] user du Desktop a 3 
5$256 _ /Users/user Desktop/screenshots/Ch@1/pdf e 


user®% Desktop/screenshots/ChO1/tiff 
Desktop/screenshots/Ch@1 
Desktop/screenshots/Ch@2/pdf 
Desktop/screenshots/Ch@2/ti ff 
Desktop/screenshots/Ch@2 
Desktop/screenshots/wrong resolution 
Desktop/screenshots 

Desktop 


erro:~ 


Desktop/screenshots/Ch@1/pdf 


Desktop/screenshots/Ch@1/ti ff 
Desktop/screenshots/Ch@1 
Desktop/screenshots/Ch02/pdf 
Desktop/screenshots/Ch@2/ti ff 
Desktop/screenshots/Ch@2 
Desktop/screenshots/wrong resolution 
Desktop/screenshots 


12464 Desktop 
[ferro:~] user® ff 


DETERMINE TOTAL 


ed Type the name of a LIST DISK SPACE IN KILOBYTES E4 Type a directory or 
DIRECTORY SIZE 


directory or file and press filename and press Return. 


RiSturn: ull Type du -k and a space. 


ull Type du -s and a space. The shell displays the size 


The shell displays the total of files in kilobytes. 
size of the directory in 
blocks. 


VIEW TEXT FILES 


ou can display the content of text files with the cat 
command. The name cat is short for concatenate, 


which means to join several things together into one. 


However, the cat command has additional functions 
beyond concatenation, one of which is to display files 


on-screen. You can display any file by typing this command: 


cat filename 


The screen displays the full contents of the file. If the file is 
longer than one screen, your Terminal window scrolls to 
display the whole file. 


The two types of files that you can display using the cat 
command are text and binary files. A text file consists of 
ordinary letters, numbers, spaces, and punctuation, 
collectively known as plain text. If you are using a word- 
processing program and you save the file as text, you are 
creating a text file. 
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Boe. ee 
[ferro: = userk Ts” 

Desktop Movies Pictures 
Documents Music Public 
Librery Note to Moe doc Sites 


[ferro:~] userx 


My To-Do List 


my-dog. jpg 
to-do.txt 


- Finish chapter 4 
~ Write tutorial for CSS site 
- Email Vicki 


[ferro:~] users Jj 


VIEW TEXT FILES 2 Type the name of a text 


1 Type cat and a space. file and press Return. 


The shell displays the 
contents of the file. 


a SS... SS se 


The other type of file that the cat command can display 

is a binary file. Binary files contain special characters that 
you cannot print, because the computer codes for these 
characters do not correspond to any printable symbols. The 
executable files that programmers create from compiled 
applications are often binary files, as are proprietary data 
formats such as Microsoft Word documents. 


If you try to use the cat command to display a binary file, 
the best that you can expect is gibberish in your Terminal 
window. The worst result is that it resets the display format 
of your Terminal window, meaning that your prompt and 
any letters you type also appear as gibberish. 


To display the contents of a binary file safely, you can use 
the -v option with the cat command. This command 
displays non-printable characters by showing a caret (‘) 
before control characters, and M- before Meta characters. 
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Hemming OD ee 


my-dog. jpg 
to-do. txt 


Movies Pictures 
Public 
Note toj]Mom, doe Sites 

r%|cat_-v|my-dog. jpa| 


AGABAGABABABAGNOABNBABABABAGABABABNENY j NANBABNBABNBABABNBABABABABAGABAGABA 
BABABABMEABAGAGABABABADABABABABA GABE ABABA BABABDAGABABABAGABA MABABABAGAAAR 
ABABA@ABABADABABIAGABABABAGA BABABABABA BABABADABA MABABABABABABAGABABDADABAGA 
BADABAGAGEABAGABABAGABABAGABAGABABAGAT a te ?M~[4@M-ADA@ALAH 


AGAL 


AMALALANARAAASARAPAPARSAZA[AUAAL& ~~ *& PT QGE ;O3A3)*<Q<AGIMNM. STZTKZEKMJAAAL 
AMAMARAOARHASAS#I4*1IIIIIIIIIIIIIIIIIPIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIM-A 
7M-@ABAQAHAAM- 3A AM~APACAA | ABABAQAAACAQAAM-A2M- DAAM~ "A@AGAAAE AAARAAAAABAAA 
@ABABAGABABAGAWA AABACADAEAFAGAH 

AKAPA@ABAAACACABADACAE AEADADABAGAA FAA SBACAG@ADAQAEAR ! LAAFASQAAG" QAT2M-AAM- 
AQM~ 1 AH#BM-1M~AAURM-QM-p$3brM-AB 

AVAWAKAYAZN& '() "456789: CDEFGHLISTUVWXTZcdefghi jstuvwxyzM-ACM-ADM-AEM-AFM- 
AGM-AHM-ATM-A JM-ARM~ASM-ATM-AUM-AVM~AIBM~AXM-AYM-AZM- °M-#M- $M-%M-8M- "M-(M- 
)M- *M- 2M-3M-4M-SM-6M-~ 7M-8M-9M-~ :M-~BM~ CI-OM~ EM- FM~ GM~HM~IM~ JM-RM~ SM~TM-UM-V 
M-vfM-XM_YM_ZM-oM-bM-cM-dM-eM- fM-gM-hMFiM- jM-gM-rM- sM-tM_uM-vM-wM-xM-yM-24 


i The shell displays the 
contents of the file, with 
non-printing characters 
shown. 


LE Type cat -v and a space. 


v4 Type the name of a binary 


fi ; aa 
sa la This is an example of a 


Meta-Control-T character. 


WORK WITH TEXT 


CREATE A SIMPLE TEXT FILE 


and redirecting the output to a file. If you type cat 

and press Return, the cat command appears to do 
nothing, but your prompt does not reappear. When you 
type something else and press Return, you just see whatever 
you typed echo back at you. This means that the cat 
command is letting you enter content. You are building a 
virtual file that only exists for the execution of the 
command. As long as you continue to type, you are adding 
content to that virtual file. 


Y ou can create a text file by using the cat command 


To indicate that you are finished entering text into the cat 
command, you must indicate the end of your virtual file. You 
do this by pressing Return and then pressing Control + D. 


By itself, the ability to type text and see it reappear 
on-screen is not particularly useful. However, you can 
combine the cat command with output redirection to 


make simple text files. Output redirection means that you 
save the results of a command to a file instead of displaying 
them on-screen. To redirect the output of the cat 
command to a file, you can type the following: 


cat > filename 


This creates a new file called filename. For better 
compatibility with the Mac OS X Finder, you may want to 
name a text file with the extension .txt. This allows you to 
double-click the icon for the file in Finder and open it in the 
TextEdit application. 


The contents of the new file are whatever you type after 
pressing Return. The file can contain multiple lines; just 
press Return at the end of each line. When you are done, 
you can press Control + D to create the file. 


CREATE A SIMPLE TEXT FILE 


Terminal — tryp1 ~ a 


Tferro:~] user%[cat]>|this-week. txt | 
ila 


E} Type the name of the file 
you want to create, and press 
Return. 


LB Type cat and a space. 


v4 Type a greater-than 
symbol and a space. 


Terminal File Edit Scroilback 


—————— Terminal — etypl = 
ferro:~] user® cat > this-week. txt 
Monday: nothing planned 
Tuesday: work out at the gym 
class in the evening 
class in the evening 
writers group 
work out at the gym 
Friday: nothing planned 
Lferro:~] user® 1s 
Movies 
Music 
Note to Mom.doc 


Font Window Help 


Wednesday: 
Thursday: 


Pictures 
Public 
Sites 


my~dog. Ipg 
this-week txt 
to-do.txt 


nothing planned 

work out at the gym 

class in the evening 
class in the evening 

writers group 

work out at the gym 
nothing planned 

~] user% 


Wednesday: 
Thursday: 


Friday: 


|G | Press Control + D. 


The cat command creates 
a file containing the text you 
typed. 


Type the text you want 
the file to contain. 


5] Press Return. 


VIEW TEXT FILES AS PAGES 


the less command. If you try to view a long file with 

the cat command, it quickly scrolls your Terminal 
window, and you must use the scroll bars to go back. The 
less command is an example of a pager command, a 
program that displays files one page at a time. 


Y ou can display long files one screen at a time using 


The less command displays a screen at a time, and waits 
for you to finish reading that screen before continuing. 
When you are ready to move ahead in the file, you can 
press the Spacebar. 


You can also search ahead in the file for a specific text 
pattern by typing a forward slash (/) and then the text you 
want to find. This moves you ahead in the file to the next 
place that text appears. 


If you try to use the less command on a binary file with 
unprintable characters, the less command warns you and 
asks if you want to continue. You can type y, for yes, and press 
Return, or simply press Return to cancel the less command. 


You have already used the less command if you have used 
the man command; when you type man, you read a manual 
page by viewing it as you would with the less command. 


The name of the less command makes sense when you 
know the history of pager commands in Unix. The original 
command for displaying a page at a time was named more, 
because, while waiting for you to read the page, it printed 
--More-- on the bottom line of the Terminal window. The 
less command was named as a natural successor to the 
more command, because it could do more than the more 
command could do. 


VIEW TEXT FILES AS PAGES 
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VIEW A FILE, PAGE BY PAGE 


@ The less command 
displays the first page of the 
content of the file. 


ul) Type less and a space. 


74] Type the name of a file 
and press Return. 


E] Press the Spacebar. 
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The shell displays the next 
page of text. 


e Terminal File Edit 


aardvark 
aardwolf 
Aaron 
Aaronic 
Aaronical 
Aaronite 
Aaronitic 


SEARCH AHEAD FOR 
A CERTAIN WORD 


4 Type a forward slash. 


WORK WITH TEXT 


In addition to pressing the Spacebar to page through a file using 

the less command, or the man command, you can also use other 
keystrokes to move through the file. For a full listing of keystrokes 
in less, type man less or type h while using the less command. 


KEYSTROKE 


b 


g 


MEANING 


Go back one page. 


?Ppattern Search backwards in the file. 


Scroiiback Font Windew Help 


i The cursor appears in 

the lower-left corner of the 
Terminal window, beside the 
forward slash. 


Ki Type a word or phrase 
and press Return. 


Quit immediately. 
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antipapacy 
antipapal 
antipapalist 
antipapism 
antipapist 
antipapistical 
antiparabema 
antiparagraphe 
antiparagraphic 
antiparallel 
antiparallelogram 
oantiparalytic 
antiparalytical 
antiparasitic 
antiparastatitis 
antiparLiament 
antiparliamental 
antiparliamentarist 
antiparLiomentary 
antipart 


The less command skips 
ahead to that word or phrase 
and highlights it. 


VIEW PORTIONS OF A TEXT FILE 


head and tail commands. To understand how the 

head and tail commands work, it is useful to 
visualize a text file as if it were a fish being chopped into 
head, tail, and body. The head command displays the 
portion of the fish containing its head, and the tail 
command shows the portion containing the tail of the fish. 
You can give additional options that indicate where along 
the body of the fish you want to cut. 


Y ou can display a portion of a text file by using the 


Without any options, the head command shows the first 
ten lines of a specified file and the tail command shows 
the last ten lines. If the file has ten or fewer lines, the whole 
file displays. 


You can change the number of lines that display in the 
following way: 


head 
tail 


-linenumber filename 
-linenumber filename 


For example, type head -3 /usr/share/dict/words to see the 
first three lines of the file /usr/share/dict/words. Several 
Unix programs use this text file as a source of English words, 
so it makes a good example for text commands. 


Typing tail -3 /usr/share/dict/words shows you the last three 
lines of this file. You can also tell the tail command to 
start a certain number of lines in from the beginning of the 
file by including a plus symbol: 


tail +linenumber filename 


if you want to view the tail of the words file starting at line 
234,567 — it is a large file — you can type tail +234567 
/ust/share/dict/words. 


VIEW PORTIONS OF A TEXT FILE 
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erro:~] user lhead |/usr/share/dict/words 


 rpntennsionbonotthe ake # 2 lane n Erase ZA NAS FLAN INESE SAR NEE 
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VIEW THE BEGINNING 


4 Type a filename and press 
OF ATEXT FILE 


Return. 
BE Type head and a space. The shell displays the first 
ten lines of the file. 


“ying 


: work out at the gym 
class in the evening 


Type head and a space. EI Type the filename and 


Type a dash, the number press Return. 


of lines you want to display, 
and a space. 


The shell displays as many 
lines of the file as you specify. 


WORK WITH TEXT 


You can also set the tail command to display any new lines added to the end of a 
file, by using the -£ option. 


The Mac OS X operating system maintains a number of files known as /og files. 
These files record system activity, much of it invisible to the user, which you can 
use to diagnose problems or monitor processes. New lines are regularly appended 
to log files. You can find most of the important system logs in the /var/log directory. 


You can monitor these log files by using the tail -f command. To stop 
monitoring these files, press Control + C. 


Example: 
{ferro:~] user% tail -5 -f£ /var/log/system.log 


Dec 2 16:40:03 ferro configd{105}]: executing 
/System/Library/SystemConfiguration/Kicker .bundle/Resources/restart~AppleTalk 


Dec 2 16:40:03 ferro lookupd[533]: lookupd (version 272) starting - Mon Dec 
2 16:40:03 2002 


Dec 2 16:40:05 ferro root: setting hostname to ferro.local. 


Dec 2 16:40:05 ferro configd[105]: executing 
/System/Library/SystemConfiguration/Kicker .bundle/Resources/set-hostname 


Dec 2 16:40:06 ferro root: setting hostname to ferro.local. 
*E 
{ferro:~] user% 
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EE Li SIP ance nintnnnnnoninng — fA IOP a ———— = 
: 
work out a the gym f 
class in the evening f 
class in the evening a 
writers group 3 
work out at the gym 3 
Friday: nothing planned 
it 
iy 
_ — — . ae: 
VIEW THE END OF A TEXT FILE 74, Type the filename and START IN THE MIDDLE EA Type the filename and 
EB iype ellfiandiaspace press Return. See EE ie ||) Mess Retum: 
] The shell displays the last a3) Type tail and a space. ] The shell displays the file 
ten lines of the file. J Type a plus symbol, the starting at the line you 


number of the line you want _—specify. 
to start from, and a space. 


45 | 


EXTRACT TEXT FROM A FILE 


match a specific pattern with the grep command. 

The grep command searches through a file to find 
lines that match a regular expression. Regular expressions, 
or regexps, are commonly used to match text patterns. 
Regular expressions are more powerful and flexible than 
normal glob patterns because they can match a variety of 
patterns and you can combine them to form very complex 
expressions. 


Y™ can find and display lines within a text file that 


The syntax for the grep command is: 


grep ‘pattern’ filename 


You do not need to enclose the regular expression pattern 
in single quotes. However, if you do not use the single 
quotes, the shell interprets the pattern as a glob pattern 
and matches it against files in the current directory. For this 
reason, it is always a good practice to use single quotes 


EXTRACT TEXT FROM A FILE 


around your regular expression pattern with the grep 
command. 


Options for the grep command include -i, which makes 
grep consider upper- and lowercase letters the same for 
matching purposes; -v, which inverts the search and lists 
lines that do not match; and -1, which does not display 
matches but instead lists the names of files whose contents 
contain the regular expression pattern. 


A simple but useful example of the power of the grep 
command is that it can help you with crossword puzzles or 
crossword-style games such as Scrabble. Using the list of 
English words in /usr/share/dict/words, you can display all 
lines matching a specific pattern. For example, if the first 
letter in a four-letter word is k, the third is n, and you do 
not know the rest, you can use this command to display all 
possible matches as show below: 


'k.n.$' /usr/share/dict/words 


grep -i 


Scroliback 


Ferminal File Edit Font Window Help 


ace Terminal — trypt 
(ferro:~] user® cat this-week.txt 
Monday: nothing planned 
Tuesday: work out at the gym 
class in the evening 
class in the evening 
writers igroup 
work out at the 
Friday: nothing planned 
[ferro:~] userx [grep] "day '[this-week. txt] 
nothing planned 
work out at the gym 
class in the evening 
writers group 
nothing planned 
[ferro:~] user% 


Thursday: 


EXTRACT TEXT USING 


4} Type a filename and press 
THE GREP COMMAND 


Return. 


Ll Type grep and a space. The shell displays all lines 


in the file that match the 


FA Type a regular expression 
pattern. 


pattern enclosed in single 
quotes, and a space. 


46 


[eo9e 


CHEAT ON CROSSWORD 
PUZZLES 


single quote, and a caret. 


Fite 
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Terminal — ttyp1_ 


igrep -i ‘4 .n|$’ /usr/share/dict/words] 


{ferro:~] user% 


{ferro:~] user% fj 


4 Type a dollar sign, a 
closing quote mark, a space, 
/ust/share/dict/words, and 
press Return. 


4 Type grep -i, a space, a 


i The shell displays all 


74 Type each letter you 
o : words that might fit. 


know, and type a period for 


each letter you do not know. 


Regular expressions consist of ordinary text 
and characters with special meanings. The 
simplest regular expression is just plain text, 
such as Kynn. This matches any line that 


contains the word Kynn anywhere on the line. 


To select matches at the beginning of a line, 
you can use the special character caret (‘). 
The regular expression to match lines starting 
with Kynn is “Kynn. Likewise, the dollar sign 
($) indicates the end of a line, as with Kynn§, 
which only matches lines where Kynn is the 
final text of that line. 


* ‘Terminal File Edit Scrofiback Font Window Heip 


aN ee er 
(ferro:~] user® cat this-week. txt 
Monday: nothing planned 
Tuesday: work out at the gym 
class in the evening 
class in the evening 
writers 
work out] at the| gym 
Friday: nothing planned 
[ferro:~] userx 
class in the evening 


{ferro:~] user® § 


Wednesday: 
Thursday: 


INVERT A GREP SEARCH 


<j) Type a filename and press 
Return. 


LN Type grep -v and a space. 
§ The grep command 
displays all lines that do 
not match your pattern. 


24 Type a regular expression 
pattern in quotes for lines you 
do not want to match, and a 
space. 


WORK WITH TEXT 


A period (.) matches any character. A set of characters 
in square brackets, such as [0123456789ABCDEF], 
matches any of those characters, and a range in 
brackets matches any character within that range, 
such as [a-zA-Z]. 


To match more than one character of the same type, 
you can use the plus symbol (+) after a special 
character, normal character, or range. To match zero 
or more of the preceding types of characters, use an 
asterisk (*). The regular expression '.*' matches 
anything, because it is zero or more of any character. 
A question mark (?) indicates zero or one repetition 
of the preceding character. 


It nceatrbetehalanaie stow ech tl RIS HAAR finan nat an de 


[ferro:~] user® is 
README connectives propernames web2 web2a 


[ferro:~] user%[grep -1|‘*name'| /usr/share/dict/* 


/usr/share/dict/web 
fusr/share/dict/webZa 
/usr/share/dict/words 


[ferro:~] user® 


words 
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# 


LIST ALL FILES CONTAINING 


EJ Type an asterisk wildcard 
A PATTERN 


to search all files, and press 
Return, 


a Type grep -I and a space. 


The shell displays the 
names of all files that contain 


the pattern. 


¥4 Type a regular expression 
pattern enclosed in single 
quotes, and a space. 


REDIRECT TEXT TO A FILE 


ou can save the text output of any shell command by 

redirecting the output to a file. Unix shell commands 

normally display their output in the Terminal shell 
window, immediately after you type the command. This 
display method is known as standard output. Using output 
redirection, you can change the destination of the standard 
output; it does not have to appear in the Terminal window. 


To save the output of a command into a file, you can use a 
greater-than symbol (>): 


command and arguments > output-file 


For example, to save the output from the command grep 
‘Apple' CHANGES.txt into a file named apple- 
changes.txt, you can use this command: 


grep 'Apple' CHANGES.txt > apple-changes.txt 


You can use the grep command to record the output of a 
command for later processing, such as editing or printing 
the file. It is also an effective way of making a record of 


REDIRECT TEXT TO A FILE 
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[ferro:~] user% ff 


SAVE COMMAND OUTPUT 3 Type a greater-than 


EM Type a Unix shell symbol and a space. 
command that displays text 3 Type the name of the file 
output, and a space. 


Return. 


you want to create and press 


information at any given time. For example, if you want to 
record your disk usage on a certain date, you can type 
command du -s > du-2003-03-05. 


When you redirect text, the shell does not print any special 
messages on-screen; after you complete the command, you 
only see the prompt again. You can use other commands, 
such as cat, grep, or head, to examine the text file that 
you create. 


You can combine output redirection with the cat 
command to create a new file from two or more files. You 
do this by using the following command: 


cat filenamel filename2 filename3 > 
composite-file 


The new composite-file consists of the text contained in 
each of the named files, in the order listed on the command 
line. You can concatenate as many files as you like. 


Terminal File Edit Seroliback Font Window Help 
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{ferro:~] user® 1s -1 > 1s-output.txt 


{ferro:~] user® 1s 
Desktop Music Sites 


to~da.txt 


Documents Note to Mom.doc  1s-output.txt 
Library Pictures my-dog . jpg 
Movies Public this-week.txt 


(ferro:~] user® cat 1s-output.txt 


Sleedetetel 1:52 Desktop 
drwx------ 4 user staff 136 Dec 1:36 Documents 
drwx------ 22 user staff 748 Nov 13 03:48 Library 
OrAx-~-- ~~ 3 user staff 102 Nov 3:49 Movies 
drwx-~---- 3 user staff 102 Nov 3:49 Music 
mPa me nnn 1 user staff 6@ Nov 18 15:11 Note to Mom.doc 
drwx------ 3 user staff 1@2 Nov 1 


3:49 Public 
3:49 Sites 
1:53 Ls-output.txt 
5:13 my-dog. jpg 
1:48 this-week.txt 
to-do. txt 


drwxr-xe-x 4 user staff 136 Nov 
drwxr-xr-x 8 user staff 272 Nov 2 
-re-r--f-- user staff @ Dec 


-Pwer--r-- louser staff 20@ Dec 
-PW-Pwe rn 
[ferro:~] user® 


294 
20 
3@ 
AS; 
41 
Bi 
8 15:42 Pictures 
41 
8 2 
20 
8 1! 
210 
29 


§ The shell saves the output 
in the file you create. 


rN 


WORK WITH TEXT 


If you redirect output to an existing file, you overwrite that 
file with the new text output. This can be dangerous, because 
indiscriminately overwriting files can lead to loss of data. 


You can instruct the shell to prevent output redirection 
from overwriting existing files by typing the command set 
noclobber. The shell prints an error message saying that the 
destination file exists, and the command does not execute. 


If you have the noclobber command set and you need to 
overwrite an existing file, you can type an exclamation point 
()), or bang, after the greater-than symbol. This causes the 
redirection to occur even if the file exists. 


Example: 


[ferro:~] user% head /var/log/system.log > log 
{ferro:~] user% set noclobber 
{ferro:~] user% tail /var/log/system.lag > lag 


log: File exists. 


[ferro:~] user% tail /var/log/system.log >! lag 


[ferro:~] user% 
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0 ee 


(ferro:~] user% 1s 
Desktop Music Sites to-do .txt 
Documents Note to Mom.doc 1s-output.txt 
Pictures my-dog. jpg 
this-week .txt 


[cat |to-do.txt this-week.txt]> my-schedule. txt 


{ferro:~] user® 


CONCATENATE TWO TEXT FILES 3 Type ad greater-than 
symbol, a space, and the 
name of the file you want to 
74 Type the name of two or create, 


more files, separated by a 
space. EZ] Press Return. 


uli Type cat and a space. 


@ Terminal file Edit Scroliback font Window Help 


[ferro:~] user® 1s 

Desktop Music Sites to-do.txt 
Documents Note to Mom.doc 15-output.txt 

Library Pictures my-dog. jpg 

Movies Public this-week.txt 

{ferro:~] user® cat to-do,txt this-week.txt > my-schedule.txt 
{ferro:~] user® cat my-schedule, txt 

My To-Do List 


- Finish chapter 4 
- Write tutorial for CSS site 
~ Email Vicki 
- Work on accessibility proposal 
Monday: nothing planned 
Tuesday: work out at the gym 
class in the evening 
class in the evening 
writers group 
work out at the gym 
nothing planned 


The cat command 
concatenates the file and 
saves the output in the file 
you create. 


CHAIN TEXT COMMANDS TOGETHER 


ou can chain commands together by sending the 
output of one command as input to another. This is 


known as piping, and is an alternative way to use 
standard output. Instead of displaying on-screen or saving 
to a file, the standard output from one command becomes 
the standard input for another command. The second 
command runs using the output from the first command, 
and produces its own standard output, which you can then 
display, redirect to a file, or pipe to another command. 


This technique gets its name from a special character called 
the vertical pipe (|). On Apple keyboards, you create this 
character by holding down the shift key and typing a 


backslash (\). The syntax for a pipe command looks like this: 


first command and arguments | second command 
and arguments 


You can link together as many commands as you want to 
using pipes. Most commands that work with text, such as 
head, tail, grep, and others, automatically accept 

standard input if there is no filename given to the second 


command. Some commands do not automatically read 
standard input. For those commands, you must read the 
manual pages, but the most common way to indicate that a 
command should read standard input is to use a single dash 
(-) as an argument. 


Piping is similar to redirecting output to a temporary file 
and then applying a second command to that file, but it 
cuts out the middleman. For example: 


[ferro:~] user% tail /var/log/system.log > 
log.tmp 

{ferro:~] user% grep ‘ferro.local' log.tmp 
Dec 2 16:40:06 ferro root: setting hostname 
to ferro. local: 

[ferro:~] user% rm log.tmp 

{[ferro:~] user% 


You can accomplish the same result with a single command 
line: 


tail /var/log/system.log | grep "ferro.local" 


CHAIN TEXT COMMANDS TOGETHER 


m Yerminal File Edit Scroliback Font Window Help 


Oe 


[ferro:~] user%|1s -1| 18] 


CHAIN TEXT COMMANDS 
TOGETHER 


4 Type a space, a vertical 
pipe character, and another 
space. 


al Type a Unix shell 
command that displays 
text output. 


[ ¢ R  Yerminal File Edit Scroliback font Window Help 


884 Dec 
136 Dec 
22 user 748 Nov 1 


Zz :56 Desktop 
2 
3 
3 user 182 Nov 4 
4 
8 


+36 Documents 
:4@ Library 
749 Movies 

3 user 102 Nov 749 Music 

3 user 102 Nov 18 15:42 Pictures 
drexr-xr-x 4 user 136 Nov 4 13:49 Public 
drwxr-xr-x 8 user 272 Nov 2@ 23:49 Sites 
{ferro:~] userX ff 


& The shell executes the first 
command and pipes the 
output to the second 
command as input. 


Type a second command 
to run on the output of the 
first command, and press 
Return. 
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___ Terminal ftypl 


grep AK /usr/share/dict/words iTarep -i ? 


Kalapooian 
kaleidophon 
kolian 
Kalmarian 
kalon 
kalymmaukion 
Kamasin 
Kamcheatkan 
kameel doorn 
kameelthorn 


MATCH TWO PATTERNS 
WITH GREP 


LE Type grep, the first 
pattern, and the file you 
want to search. 


23 Type a space, the vertical 
pipe character, and a space. 


<# Type grep and the second 
pattern, and press Return. 


WORK WITH TEXT 


You can chain together commands using the backtick (~), a left-leaning 
single quote character found in the upper-left corner of your keyboard. 
You use the backtick to take the output of one command and provide it 
as an argument to another command. You write the second command 
normally, but where you want to insert the output of the first command, 
you enclose it within a pair of backticks. For example, to see the size 
and permissions of the executable file for the 1ess command, you type 
Is -l ‘which less’. 


This input executes the which command, which returns a full pathname 
to the less command, and then runs the 1s -1 command with that 
pathname as an argument. 


To move all files containing the word obsolete to a subdirectory, type 
mv -i ‘grep -I ‘obsolete’ *.txf old-files/ 


This input executes the grep -1 command, which displays a list of files 
containing the search pattern, and that list is used as a set of arguments 
to the mv command. 
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Terminal — typi 


Terminat 


(Ferro: ~ users® 


Kabistan 
Kachin 
kachin 
Kadayan 
kadein 
Kaffrarian 
kafirin 
kainyn 
Kakan 
Kalamian 
Kalapooian 
kaleidophon 
kalian 
Kalmarian 


PIPE OUTPUT THROUGH 


THE LESS COMMAND Return. 


I The grep commands LB Type a Unix shell 
display lines of text matching command and a space. 
al 74 Type a vertical pipe less command for paging. 


character and a space. 


rep =i ‘Ak. *n$* Jasr/sharefdict/ words) [ite scion | 


<i Type less and press 


The output of the 
command is piped to the 


COMPARE TEXT FILES 


command, which shows you the differences between 

the files. You can compare three files by using the 
dif£3 command. You use the diff command if you want 
to compare two versions of the same file to see whether 
the file has changed. The syntax for the diff command is: 


Y° can compare two files by using the diff 


@iff first-file second-file 


The output from the di ££ command consists of those lines 
that are not the same in both files. If the files are identical, 
the diff command prints nothing; you only see the 
command line prompt again. 


If there are differences, the dif£ command reports them in 
the following manner: The first line indicates the line 
numbers within each file, with a single letter between the 


COMPARE TEXT FILES 


[ @& Terminal file Edit Scroliback Font Window Help 
888 Terminal —tcsh (typl) 

[ferro:~] user% cat to-do. txt 

My To-Do List 


~ Finish chapter 4 
- Write tutorial for CSS site 

~ Email Vicki 

~ Work on accessibility proposal 
(ferro:~] user® cat done. txt 

My To-Do List 


X Finish chapter] 3 
- Email Vicki 

X Email Jade 
[ferro:~} users[diFF[ to-do. txt] done. txt] 
+a. 

< - Finish chapter 4 
<~ Write tutorial for CSS site 

> X Finish chapter 3 

6c5 

< » Work on accessibility proposal 


> X Email Jade 


COMPARE TWO TEXT FILES Eq Type the name of a 
different file and press 


Return. 


Type diff and a space. 


EJ Type the name of one file 


and a space. i The shell displays the 


differences between the files. 


lines or range of lines. The letter tells whether an addition 
was made, a, a line was deleted, d, or a line was changed, c. 
The versions from each file then appear, preceded by a less- 
than symbol for lines in the first file, and a greater-than 
symbol for lines in the second file. 


You can also use the diff command to compare non-text 
binary files; however, the diff command does not print 
the actual differences between files, because these are 
likely to be non-printable characters. Instead, diff returns 
you to the prompt if the files are identical, or prints a 
message saying that the binary files differ from each other. 


The diff command only compares two files. If you need to 
compare three files, you can use the di f£3 command. 
Note that there is not a dif £4 command. 


% Terminal File Edit Scrollback Font Window Heip 
Terminal oe tosh (ttyp1) 


(ferro:~] user® cat to~do, txt 
My To-Do List 


- Finish chapter 4 

- Write tutorial for CSS site 

~ Email Vicki 

- Work on accessibility proposal 
(ferro:~] user® cat done.txt 

My To-Do List 


X Finish chapter 3 
~ Email Vicki 
X Email Jade 


[ferro:~] user® diff to-do.txt done. txt 


«< ~ Finish chapter 4 
Wee u 


>» X Finish chapter 3 
6cS 
< ~ Work on accessibility proposal 


The shell indicates that 
lines 3 and 4 have changed 
between the first and second 
files. 


A less-than symbol 
indicates a line change 
in the first file. 


A greater-than symbol 
indicates a line change 
in the second file. 


as SS. aa ss 


WORK WITH TEXT 


Terminal File Edit Scrolfback 


Binary. files wankd_03@. es and yawn 
[ferro:~/Pictures] user® §j 


COMPARE TWO BINARY FILES 
ul Type diff and a space. 


74 Type the name of one file, 
a space, and the name of 
another file, and press 
Return. 


if you use output redirection to save the 
output of the diff command into a file, 
the result is a diff file. You can use a diff 
file to record changes between text files. 
For example, you may want to update a 
Web page by saving a copy of the HTML 
text document and then changing a few 
lines. You can use the diff command 
to determine what changes you made, 
and save the results in a diff file. 


Font Window Help 


Note: If the files differ, the shel! 
displays a message. If the files are 
identical, no message appears. 


The patch application uses a diff file to update an original 
file with the changes made to the diff file. This is useful if 
you are compiling new applications from updated source 
code. You can also use the patch application to update a 
configuration file or any other text file. The syntax for the 
patch command is 


patch original-file diff-file 


The original file, without the patches applied, is saved as 
original-file.orig. 


You can use the output of the diff command with the ed 
command, a command line tool that lets you edit text. To 
make the output of the di f£ command into an instruction 
list, or ed script, that the ed command understands, use the 
-e option with the diff command. 


| Terminal File Edit Scroliback Fort Window Heip 
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- Finish chapter 4 
- Write tutorial for CSS site 
2:3c 

X Finish chapter 3 
3:3,4¢ 

X Finish chapter 2 
~ Finish chapter 3 


1:6c 
~ Work on accessibility proposal 
2:$¢ 
X Email Jade 
3:6¢ 
~ Email Jade 


COMPARE THREE FILES 74 Type three filenames 
separated by spaces, and 


ig Type diff3 and a space. press Return. 


The shell displays the 
differences between the files. 


COUNT CHARACTERS, LINES, 


AND WORDS IN TEXT 


letters in a file by using the wc command. The wc 

command, short for word count, also counts the 
number of lines and characters, or bytes, in a file. The 
output of the wc command looks like this: 


y ou can measure the number of lines, words, and 


lines words characters filename 


The lines value is the number of lines in the text. The 
words value is the number of words; a word, for this 
purpose, is any group of characters that does not contain a 
blank line or space. The characters value includes printed 
letters, numbers, and symbols, as well as blank lines and 
spaces. 


You can tell the wc command to print only the lines, words, 
or characters by using the -1, -w, and -c options, 
respectively. If you do not specify any of these options, the 
we command lists all three values. 


The wc command can also count lines, words, and 
characters from standard output. You can use the wc 
command to count the results of other commands, such as 
the grep command. 


For example, to count how many lines in a file contain a 
specific pattern, you can use this command: 


grep ‘pattern’ filename | we -1 


Keep in mind that this counts the number of lines that the 
grep command returns, and not the number of times that 
the pattern appears in the file. A single line may have the 
pattern repeated many times; thus, this is not an accurate 
way to count the number of times a word, or pattern, 
appears in a text file. 


To count the number of files in a directory, you can pipe the 
output of the 1s command to the wc -1 command. 


COUNT CHARACTERS, LINES, AND WORDS IN TEXT 


@ Terminal file Edit Scroliback Font Window Help 
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(ferro:~} user® 1s -1a my-schedule. txt 

~Mwete«r~» luser staff 311 Dec 2 61:54 my~schedule.tat 
[ferro:~] user® cat my-schedule. txt 

My To-Do List 


~ Finish chapter 4 

- Write tutorial for CSS site 

~ Email Vicki 

~ Work on accessibility proposal 

Monday: nothing planned 

Tuesday: work out at the gym 
class in the evening 

Wednesday: class in the evening 


Thursday: writers group 


work put at the lgym 
Friday: nothing] planned 


[ferro:~] user% lwc |{my- schedule. tx 


{ferro:~] user% 


COUNT WORDS AND 


The shell displays the 
LINES INTEXT 


number of lines, words, and 


ER Type we and a space. characters, respectively. 


74 Type the name of a file 
and press Return. 


FILES IN A DIRECTORY 


rere user% fis|/usr/bin |i we -1| 


{ferro:~] user% Jj 


COUNT THE NUMBER OF 


3 Type a vertical pipe 
character and we -I, then 
press Return. 


LB Type Is and a space. 


The shell displays the 
number of lines of output 
from the 1s command. 


Z4 Type the pathname of a 
directory and a space. 


WORK WITH TEXT 


ARRANGE TEXT IN COLUMNS 


ou can create neatly arranged columns of text by 

using the column command. It is easier to read long 

lists if they appear in multiple columns, as this allows 
you to see more of a file in the Terminal window. The 
column command arranges your text lists into columns, 
based on the width of your Terminal window. The syntax of 
the column command is: 


column filename 


You can also provide a list to the column command from 
another command by piping the output to the column 
command. For example, if you want to make columns from 
the output of the grep command, you can type the 
following: 


grep ‘pattern’ filename | column 


ARRANGE TEXT IN COLUMNS 


Terminal File Edit Scroliback Font Window Help 


£62 |... Ferrminal — tesh eryph) 
(ferro:~] user% gre 


Keres knackebred 

Keresan knacker 

Kerewa knackery 

kerf 

kerflap 

kerflop 

kerf Lumtmox 

Kerite 

Kermanji knapbottle 

Kermanshah knape 

kermes knappan 

kermesic knapper 

kermesite knappiskh 
Kabirpanthi kermis knappishly 
Kabistan kern knapsack 
Kabonga kernel knapsacked 
kabuki kerneled knapsacking 
Kabuli kernelless knapweed 
Kabyle kernelly knar 
Kachari kerner knack 


Kachin kernetty 
kachin kernish knarry 


knarred 


Kadaga kernite Knoutia 


FILL COLUMNS VERTICALLY 


UN Type column and a space. file in columns. 


EJ Type the name of the 
input file and press Return. 


a pactdctoner tiranectas —<—— oO 


The shell displays the input | FILL COLUMNS HORIZONTALLY 


The maximum width of the lines in the input file determines 
the width of each column. If, for example, your Terminal 
window is 80 characters across and the maximum width of all 
lines within the file is 21, then you can have three columns. 
You cannot have four columns, because they would exceed 
the width of the Terminal window. If the longest line in the 
file is 50 characters wide, then you can only have one 
column, because you cannot have two columns of 50 
characters each within an 80-character Terminal window. 


The column command arranges the items in the list vertically 
in columns. The second item appears under the first item, 
and continues until you reach the bottom of the first column. 
The list then continues at the top of the second column. If 
you want your columns to run horizontally instead of 
vertically, you can use the -x option with the column 
command. 


% Terminal File Edit Scroilback Font Window Help 
[column x] 
k 


Kabaka 

Kabard Kabardian 

Kabbel jars, kabel 
Kabirpanthi Kabistan 
kabuki Kabuli 
Kachari Kachin 
Kadaga Kadarite 
Kadayan Kaddish 
kadikane kadischi 
kados 

kaempferol Kaf 

kaferita Kaffir 
Kaffreria 
kafir 
kafiz 
kagu 
kahau kahikatea 
kahu kahuna 
Kaibab Kaibartha 
kaik kaikara 
kail kailyard 
kailyardism Kaimo 
kainga kainite 


The shell displays the input 
file in columns, but in 


LB Type eoltwnn cand a horizontal order. 


space. 


74) Type the name of the 
input file and press Return. 


SORTING TEXT 


ou can sort lines of text by using the sort command. 

You can eliminate duplicate lines in sorted text by 

using the unig command. Sorted text is easier to 
read, especially when you are comparing values or locating 
a specific word in a list. The sort command makes it easy 
to do this automatically rather than manually. 


You can control the sort command by using options, based 
on the type of list you want to sort. By default, the sort 
command uses character order. This seems sensible at first, 
except that computers sort uppercase and lowercase letters 
in a rather confusing manner. According to your computer, 
the alphabet consists of the uppercase letters A through Z, 
then the lowercase letters a through z. So the word Yellow 
comes before the word blue, in character order, because all 
capital letters come before lowercase letters. 


You can instruct the sort command to use alphabetical 
order instead of character order with the -£ option. This 
sorts blue to come before Yellow, because the letter b 
comes before the letter Y. 


Neither way of sorting works well with numbers. All numbers 
beginning with 1 come first, and then numbers beginning 
with 2, and so on. So the number 111 comes before the 
number 28, because 111 starts with 1, and 28 starts with 2. 
To sort numerically, you can use the -n option with the sort 
command, which then sorts numbers correctly. 


A similar command to the sort command is the unig 
command. The unig command takes sorted lines of text, 
either given as a command line argument or from standard 
input, and removes those lines that are duplicates. The 
command then displays all lines that are unique. 


@ Terminal file Edit Scroflback font Window Help 
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{ferre:~] user% cat this-week.txt 

Monday: nothing planned 

Juesday: work out at the gym 
class in the evening 

Wednesday: class in the evening 

Thursday: writers group 


reed glowed fe 
Friday: nothing planned 
ferro:~] user% 
work out at the gym 
class in the evening 


Friday: nothing planned 
Monday: nothing planned 


Thursday: writers group 
Tuesday: work out at the gym 
class in the evening 


SORT A FILE IN 


The shell displays the 
CHARACTER ORDER 


contents of the file, in 


Type sort and a space. character order. 


74] Type the name of the file 
you want to sort, and press 
Return. 


SORT A FILE IN NUMERIC ORDER 


{ferro:~} user% cat priorities. txt 
My To-Do List, with priorities 


1 - Finish chapter 4 

4 ~- Write tutorial for CSS site 

3 - Email Vicki I Asal 

4 ~- Work on accessipilit 

{ferro:~] user% 


My To-Do List, with priorities 

i - Finish chapter 4 

3 + Email Vicki 

4 ~ Work on accessibility proposal 


4 + Write tutorial for CSS site 


The shell displays the 
contents of the file, in 
Type sort -n and a space. RUGRELG GRRL 

Z4) Type the name of the file 
to be sorted, and press 


Return. 


@ ‘Terminal file f£dit Scroflback Font Window Help 
= Terminal — : 
[ferro:~] userk [sort [this-week. txt 


ferro:~] user® cat this-week-sorted.txt 


909 = 


work out at the gym 
class in the evening 
nothing planned 
nothing planned 
writers group 
work out at the gym 
class in the evening 


SAVE SORTED TEXT 
ul Type sort and a space. 


4 Type the name of the file 
you want to sort, and a 
space. 


tesh (ttyp2) 


WORK WITH TEXT 


You can use the sort command with the du command to determine which 
of your subdirectories are taking up the most space. This can help you plan 
your use of disk space when it becomes limited. 


The du command lists the size of each directory and subdirectory in blocks; 
if you prefer, you can use the -k option to show kilobytes. The first column 
of each line displays the size of the file, so you can use the -n option of the 
sort command to list the directory sizes in numeric order. 


Example: 

[ferro:~] user% du -k Documents [| sort -n 
Documents /Dogs/Sounds 
Documents/Letters 
Documents/Dogs 
Documents/Dogs/Images 
Documents/To Do Lists 
Documents 


[ferro:~] user% 


The example shows that the smallest directory is the Sounds subdirectory of 
the Dogs directory, and the largest is the entire Documents directory itself. 


| @& Terminal File Edit Scroliback Font Window Heip 
8S 8 Terminal — tcsh ittypt) 


[ferro:~] user® cat mext-week.txt 
Monday: nothing plonned 
Tuesday: work out at the gym 

class in the evening 
Wednesday: lunch date 

class in the evening 
Thursday: nothing planned 
Friday: nothing planned 
[ferro:~) user% sort next-week txt 
class in the evening 
class in the evening 
nothing planned 
nothing planned 

1 _nothing planned 
Tuesday : work put at thelgym 
Wednesday: lunch date 
[ferro:~] user% 
f @ evening 

nothing planned 

nothing planned 

nothing planned 

work out at the gym 

lunch date 


Friday: 
Monday : 


<4 Type a greater-than 
symbol and the name of a 
new file, and press Return. 


The command sorts the 
contents of the file and saves 
the output in the new file. 


ELIMINATE DUPLICATE ITEMS “J Type a vertical pipe, a 

4 anda space, then uniq, and press 
ae a J Return. 

74 Type the name of the file 

you want to sort, and a 


space. 


The command sorts the file 
and removes duplicate lines. 


PRINT TEXT ON A PRINTER 


ou can print a file on your printer using the lpr If you try to print a non-text binary file, two things may 

command. You can format and print a file on a happen: If the binary file is in a format known to the 

PostScript printer with the enscript command. The printing system, such as a JPEG image file, it prints on your 
lpr, or line printer, command sends text directly to your printer. However, if it is an unknown file format, or an 
printer. The printer simply outputs the lines, in the order executable binary file, it may not print at all. 


that it receives them. The syntax for the 1pr command is Yaurean. dleo see ShsGript coniandawheeh coauetits 


lpr filename your text file to PostScript. PostScript is a computer 
language understood by many printers; you should check 

The lpr command also prints text that is piped from the your printer manual to see if it understands PostScript. If it 

standard output of another command: does, you can use the enscript command to print text. 

another command | lpr The enscript command produces better output than the 
lpr command, because PostScript lets you use special 

If you do not connect a printer to your computer, the effects. For example, you can place a large, diagonal 

lpr command does not work, and you receive an error message, such as Top Secret, in light gray underneath 

message. your text. This is known as an underlay, and is set by the 


--underlay= option of the enscript command. 


PRINT TEXT ON A PRINTER 


~ Terminal File Edit Scroiiback Font Window Heip @, ‘Terminal File Edit Scroliback Font Window Help 
929. Be el: eo 


erra.~ user®| lpr] this -week. txt @ erro:~] users lis -t[l[ipe] 
fferro:~] user% {ferro:~] user® 


PRINT A FILE ON FJ Type the name of a file PRINT COMMAND OUTPUT EJ Type Ipr and press Return. 


THE LINE PRINTER and press Return. 


BM Type a Unix shell @ The printer outputs the 
@ The printer outputs the file. | Command that displays text text. 
output, and a space. 


Type Ipr and a space. 


(73) Type a vertical pipe and a 
space. 


WORK WITH TEXT 


Additional options in the lpr and enscript commands give you 
even greater control over the appearance of your printed page. The 
-o option of 1pr allows you to set specific printing options. 


-O OPTION PRINT EFFECT 


Print in landscape, or wide, mode. 


-o number-up=16 Print sixteen pages per sheet of paper. 


-o prettyprint a Print a header with the date and filename. 


The enscript command has even more options that you can use to 
generate or print PostScript output. For a more complete list, see the 
manual page for the enscript command by typing man enscript. 


e. — = = | | [SO : scssas! Simin = seshieye}) ——e 
ferro:~] user% DRAFT ONLY* o 
i 


(ferro:~] user® 


PRINT A FILE ON A 


4 Type the name of a file PRINT AN UNDERLAY E} Type the name of the file 
POSTSCRIPT PRINTER 


and press Return. Ell Type enscript -underlayz. and press Return. 


Ll Type enscript and a space. The printer prints the file. 


The printer outputs the 
file with the text running 


diagonally beneath it. 


74 Type the underlay text in 
single quotes, and a space. 


OPEN A FILE WITH PICO 


text editor. The function of a text editor is to enable 

you to open, edit, and save plain-text files. Mac OS X 
provides several text editors for this purpose. Text editors are 
less complex than word processors; they do not allow you to 
select fonts, layouts, or other factors that affect the look of 
the printed page. 


Y ou can edit text files with Pico, a basic and easy-to-use 


Three shell editors come with Mac OS X; they are Pico, vi, 
and emacs. Although they accomplish the same basic task 
of editing text, each one has its own strengths and 
limitations. Pico is the simplest to use, because all keystroke 
commands appear on-screen, and there are not many to 
learn. Because of its simplicity, Pico is a good choice for 
new users of the Mac OS X shell as well as experienced 
users who need to do simple text editing. 


OPEN A FILE WITH PICO 


You start the Pico editor by typing pico at the command 
prompt, along with an optional filename as an argument. If 
the filename argument exists and is a text file, Pico opens 
the file for editing; if it does not exist, you start with a blank 
file. 


The list of Pico commands appears at the bottom of the 
screen. A caret (*) before a letter means that you need to 
hold down the Control key while typing a key. For example, 
the notation “X stands for Control + X. 


You can use your keyboard to easily move around in a Pico 
document. You use the arrow keys to move to the position 
you want to insert text, and then start typing. You use the 
delete key to erase text to the left of the cursor. 
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& Terminal File 


Edit Scrofiback Font Window Help 


{ferro:~/Documents] user® ls 
Letters 


OPEN A FILE WITH PICO r4 Type the name of a text 


ul Type pico and a space. file and press Return. 
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y To-Do List 


~ Finish chapter 4 
- Write tutorial for CSS site 
- Email Vicki 
- Wark on accessibility proposal 
Monday: nothing planned 
Tuesday: work out at the gym 
class tn the evening 
Wednesday: class in the evening 
Thursday: writers group 
work out at the gym 
Friday: nothing planned 


B The Pico editor opens the 


This area displays the 
file and displays it for you. 


document. 


This area displays the 


This area displays Pico 
filename. 


commands. 


WORK WITH TEXT EDITORS 


The basic keystrokes for Pico appear on-screen. The function of each keystroke 
is not immediately obvious, so this table summarizes the most useful Pico 
commands. Many of these commands are not intuitive, but the mnemonics 
may help. For example, to view the help screen you would press Control + G, 
not Control + H, so you might think of the command as getting help. 


KEYSTROKE MNEMONIC FUNCTION 


Display the location of the cursor. 

Delete the character under the cursor. 

Display the program help screens. 

Reformat a paragraph. 

iG. eleout ___ asteorecarent fe 

Insert the contents of another file. 

Quit Pico; save if necessary. 

Find text in the current file. 
AV 


AY 


= Scroll down a page. 


Scroll up a page. 


File Edit Scroliback 


Term 


Font Window Help 


inal — tryp9 
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~ Write tutorial for CSS site 

~ Email Vicki 

- Work on accessibility proposal 

Monday: nothing planned 

Tuesday; work out at the gym 

class in the evening 
class in the evening 

writers group 

work out at the gym 

nothing planned 


Wednesday: 
Thursday: 


Friday: 


ee Get Help MB WriteOut Read Fil 
i Exit i] Justify Where is 


ENTER TEXT IN PICO 


iB Position the cursor where 
you want to enter text. 
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My To-Do List 


~ Finish chapter 4 - [ALREADY DONE 19 | 


~ Write tutorial for CSS site 

~ Email Vicki 

~ Work on accessibility proposal 

Monday: nothing planned 

Tuesday: work out at the gym 

class in the evening 
class in the evening 

writers group 

work out at the gym 

nothing planned 


Wednesday: 
Thursday: 


Friday: 


Prev Pg fj Cut Text J Cur Pos = ¢ 
Next Pg if UnCut Te To Spell. 


i WriteOut @8 Read Fil Prev Pg 
Next Pg 


Type the text you want to 
add. 


cursor. 


me Cut Text 


ae UnCut aa 


@ Pico inserts your text at the 


Cur Pos 
To Spell 


EDIT A FILE WITH PICO 


ou can edit text in the Pico editor, performing basic 

tasks such as finding specific text or saving a file. Pico 

is based on the text-editing functions of the Pine 
e-mail program, a shell application that allows you to 
compose, send, and read e-mail. You can learn more about 
installing and using the Pine e-mail program in Chapter 13. 


If you edit a file with long lines, Pico does not automatically 
wrap the lines of text to fit the size of the window. Instead, 
Pico shows a dollar sign ($) at the right side of the Terminal 
window for each line that extends beyond the width of the 
window. You can view those lines by moving the cursor up 
or down with the arrow keys, and then using the right and 
left arrows to move through the line. 
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My To-Do List 


~ Finish chapter 4 
~ Write tutorial for CSS site 
~ Email Vicki 
~ Work on accessibility proposal 
Monday: nothing planned 
Tuesday: work out at the gym 
class in the evening 
Wednesday: class in the evening 
Thursday: writers group 
work out at the gym 
Friday: nothing planned 


FIND TEXT IN PICO 
1 Press Control + W. 


Type the text you want to 
find and press Return. 


The Pico text editor has several command-line options that 
you can use when starting the editor. The -£ option 
activates the function keys, although you should note that 
only the first four keys, F1 through F4, work in Mac OS X. 
The -v option opens a file in read-only mode, which means 
that you cannot make any changes in the file. 


The most useful Pico editing commands are those that find 
and modify text, save a file, and then allow you to exit the 
text editor. For example, to locate a phrase or word, you can 
press Control + W. Saving a file is the same as writing an 
output file, so you can use the Control + O command to 
save your work. If you do not save your file, and you press 
Control + X, Pico asks you whether you want to save the file. 


EDIT A FILE WITH PICO 
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My To-Do List 


- Finish chapter 4 

~ Write tutorial for CSS site 
mit Teck 

: ~ Work on accessibility proposal 
-|Monday: nothing planned 

Tuesday: work out at the gym 


class in the evening 
Wednesday: class in the evening 
Thursday: writers group 

work out at the gym 
Friday: nothing planned 


me Get Help WriteOut gf Read Fileiy Prev Pg fi Cut Text Cur Pos 
mg Exit Justify Mj Where is Mj Next Pg BB UnCut Texi To Spell 


Pico moves the cursor to 
the text. 


WORK WITH TEXT EDITORS 


You can move text within your file by using the cut-and-paste 
functions of Pico. Pico uses keyboard commands to mark, 
copy, delete, and move sections of text. Pico does not allow 
you to export text to other applications. 


To cut a section of text in Pico, move the cursor to the start 

of the text you want to cut by using the arrow keys. Press 
Control + Shift + 6. Pico marks the beginning of the text block 
that you want to select by highlighting it in black. Using the 
arrow keys, move the cursor to the end of the text selection 
and press Control + K. Pico cuts the block from the file. This 
is an easy way to delete large sections of text. 


To paste text into a new location, use the arrow keys to 
position the cursor where you want to move the deleted text 
and press Control + U. This command uncuts, or pastes, the 


text. 
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My To-Do List 


- Finish chapter 4 
- Write tutorial for CSS site 
~ Email Vicki 
- Work on accessibility proposal 
Monday: nothing planned 
Tuesday; work out at the gym 
class in the evening 

Wednesday: class in the evening 
Thursday: writers group 

work out at the gym 
nothing planned 


Friday: 


i] Cancel 


SAVE A FILE WITH PICO 
1 Press Control + O. 


§ The Pico editor prompts 
you with the current 
filename. 


Note: You can change the filename 
by using the Delete key or adding 
fext. 


Type the name of the file 
and press Return. 


@ Pico saves the file. 
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My To-Do List 


~ Finish chapter 4 

- Write tutorial for CSS site 

-~ Email Vicki 

- Work on accessibility proposal 
nothing planned 
work out at the gym 
class in the evening 


: class in the evening 
writers group 
work out at the gym 
nothing plonned 


QuiT Pico F] Type y to save your file or 
EM Press Control + X n to exit without saving. 

Bhi the Picomditorasks @ The Pico editor exits. 
whether you want to save 

your file. 


OPEN A FILE WITH VI 


ou can use the vi editor to edit text files. The vi editor 

is more powerful than Pico and can perform many 

more text-editing functions. The name vi is short for 
visual; vi is a visual editor because you can edit the files on- 
screen as you see them, as opposed to using the command 
line as you would with sed, a stream editor. To begin using 
the vi editor, you can type vi at the command prompt with 
an optional filename argument: 


vi file-name 


If you do not specify a filename, the vi editor creates a 
temporary file for you and opens that temporary file for 
editing. The name of the temporary file consists of a 
seemingly random series of characters and numbers; 


OPEN A FILE WITH VI 
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eS 


pr ————— a 


Pictures README 
Public Sites 


Movies Sounds 


Music 


E4 Type the name of a text 
file and press Return. 


a sample filename with the full path would be 
/tmp/vi.Y8pi7R, because vi stores temporary files in the 
/tmp directory. 


When vi displays a file, lines that are longer than the width 
of the Terminal screen continue on the next line. The vi 
editor breaks lines at the edge of the screen, which means 
that the first half of a word may appear at the end of one 
line, with the other half beginning on the next line. The 
word itself is still intact and whole; vi simply displays it this 
way for editing purposes. 


The vi editor automatically uses the full Terminal window. If 
there are additional lines on the screen that vi does not use 
to display the file, a tilde (~) appears at the beginning of 
each of these lines. These are not part of your file; they 
simply indicate the end of the content of the file. 
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his directory contains some useful tcsh files, 


In order to use this configuration: 


echo “source /usr/share/tcsh/exampLes/rc" > «/,tcshre 


echo "source /usr/share/tcsh/exampLes/Login” > ~/.login 
echo "source /usr/share/tcsh/exampLles/logout” > ~/. logout 


To do this system-wide, do the same instead to /etc/csh.cshrc, /etc/csh.1 
ogin, and /etc/csh. logout. 


In order to customize tcsh: 
mkdir ~/Library/init/tcsh 
and create the following files there as necessary: 


~ shell aliases 
completions 


environment - 
run commands : 


This area displays the 
document. 


ai Press Control + Shift + X 
to exit the file. 


aliases mine 

completions.mine 

environment .mine 
in 


reo, mine 
README: unmodified: Line 1 


® The vi editor opens and 
displays the file. 


M This area displays the 
filename. 
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WORK WITH TEXT EDITORS 


You can change the behavior of the vi editor by setting editor options. 
You do this by typing a colon (:), the word set, a space, and then the 
option name. For example, to turn on line numbers, type :set number. To 
turn off an option, type a colon, the word set, a space, the word no, and 
then — with no space before it — the name of the option. For example, 
to turn off line numbers, you type :set nonumber. 


OPTION FUNCTION 


[nuriber [Displaytine numbers on theleft 
[ruler [Display the current tine number and character postion 


showmode Show the current mode, for example, insert, in the lower 
right corner. 


verbose Use wordy and informative warnings and messages. 


You can see which options are currently set if you type :set and press 
Return. For a full list of all vi editor options, type :set all. 
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%[vi[tutorial-vi. ext] 


CREATE A NEW FILE WITH VI 


LB Type vi and a space. 


easier RE Seat PR 


tutorial-vi.txt: new file: line 1 


EJ Type the name of a new @ The vi editor starts and I Tilde symbols indicate the 
document and press Return. displays an empty file. end of the file. 


MOVEMENT WITHIN VI 


ou can use single keystroke commands to move 

through a file in the vi editor. One feature that 

distinguishes the vi editor from the other visual 
editors is the concept of modes. The vi editor is always 
in one of two states, Command mode or Input mode. 
Command mode allows you to use keystroke commands to 
delete lines, move text, or save files. Input mode allows you 
to type text into the document at the location of the cursor. 
While in Command mode, you can use keystroke 
commands to change to Input mode. 


The Command-mode keystrokes in the vi editor are usually 
a single letter, and, unlike the Pico editor commands, they 
are typed without holding down the Control key. However, 
the keystroke commands are case sensitive, which means 
that a is a different command than A. You need to use the 
Shift key, of course, to create the uppercase letters. 


To move within a document in vi, the application must be in 
Command mode. The vi editor offers many ways to 
navigate the content of a file, some of which appear on the 
facing page. The easiest way is to use the arrow keys to 
move the cursor, as you would in Pico. You can also use the 
lowercase letters h, j, k, and | to move the cursor around 
on-screen. 


The £ind command in vi is much like the find command 
in less. When you type a forward slash (/) and enter the 
word or phrase you are seeking, the vi editor automatically 
moves the cursor to the next occurrence of that text. If you 
type a question mark (?) instead of a forward slash, the 
search occurs backwards in the file from your current 
position. 
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il he vi editor seems complex at first 
but it is actually easy to use. The 
tricky part is the fact that there 
are two MODES: 


* The COMMAND MODE Lets you type commonds 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 


If you don’t know what mode you are in, you 
press ESC a few times until vi beeps at 


MOVING IN VI 


Pe waith vi in Connianel the end of the file. 


mode, press Shift + H to 
move to the start of the file. 


Ul 


74 Press Shift + G to move to 
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but it is actually easy to use. The 
tricky part is the fact that there 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 


HEF you don't know what mode you are in, you | 
can press ESC a few times until vi beeps 
youl 


&J] Press Shift + 6 to move to 
the beginning of a line. 


£3 Press Shift + 4 to move to 
the end of the line. 


WORK WITH TEXT EDITORS 


The commands in the table below allow you to move 
quickly through a file in vi, repositioning the cursor and 
scrolling the screen when necessary. 


KEYSTROKE 


i 
Ptext | 
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Move ahead one word. 


EFFECT 


Move to the first line of the file. 
Move to the last line of the file. 
Move one character to the left. 
Move down one line. 

Move up one line. 

Move one character to the right. 


Move to the beginning of the current line. 


Move to the end of the current line. 


Find text from the cursor forward. 


Find text from the cursor backward. 
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The vi editor seems complex at first 
but it is actually easy to use. The 
tricky part is the fact that there 
ore two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 


If you don’t know what mode you are in, you 
can press ESC a few times until vi beeps at 


The vi editor seems complex at first 
but it is actually easy to use. The 
tricky part is the fact that there 
are two MODES: 


* The COMMAND MODE lets you type commands 
ta move around 


* The INPUT MODE allows you to enter text 
If you don't know what mode you are in, you 


can press ESC a few times until vi beeps at 
ou. 


od tt toe F 


74 Type a word or phrase M The vi editor moves the 
and press Return. 


cursor to that word or phrase. 


ENTER TEXT IN VI 


ou can enter text into a document by switching to 

Input mode in vi. When you start the vi editor, it 

switches to Command mode by default, allowing you 
to move through the file or enter keystroke commands. If 
you try to enter text while in Command mode, you can 
produce some very strange results, because many 
characters correspond to keystroke commands in 
Command mode. It is therefore very important to know 
which mode you are in before you enter text. 


The easiest way to determine your current mode is to 
enable the option showmode. You can do this by typing :set 
showmode while in Command mode. Your current mode 
appears in the lower right corner. 


You can use a number of single keystrokes to switch to 
Input mode from Command mode. However, there is only 
one way to switch to Command mode from Input mode, 


and that is to press the Esc (Escape) key, located on the 
upper-left corner of most keyboards. If you are not sure 
which mode you are in, you can press the Esc key to return 
to Command mode. Pressing the Esc key while in 
Command mode does nothing, so it is safe to press this key 
several times to make sure. 


Many useful command-mode keystrokes appear in the table 
on the facing page. The most important keystrokes are i, 
which inserts text at the current cursor location, and o, 
which opens a new line below the current one and allows 
you to enter text directly. When you edit the text in your 
file, vi does not save your changes until you give the 
command to do so. 
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The vi editor seems complex at first 
but _it is actually fBhsy to use. The 
tricky part is the fact that there 
are two MODES: 


* The COMMAND MODE Lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 


If you don’t know what mode you are in, you 
can press ESC a few times until vi beeps at 


INSERTTEXT EA type the letter i. 


LB Position the cursor where 
you want to enter text. 


SC ie) | 
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Ci eT a 
The vi editor seems complex at first 
it i sontewhat |fasy to use. The 
tricky part is the fact thet there 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 


If you don't know what mode you are in, you 


can press ESC a few times until vi beeps at 
you, 


4 | Press Esc. 


Wi The vi editor switches to 
Command mode. 


@ The vi editor switches to 
Input mode. 


Type the text you want to 
insert. 


WORK WITH TEXT EDITORS 


The keystroke commands that you use to switch to Insert 
mode appear in the table below. There are other modes that 
function like Insert mode, allowing you to type text into the 
file. As with Insert mode, you can leave these modes by 
pressing the Esc key to switch to Command mode. 


KEYSTROKE MODE ENTERED 


Insert 


FUNCTION 
Append text at the end of the current line. 


Insert 


Insert 


Append text after the current character. 


Insert text at the beginning of the current line. 


Insert text at the current location. 
Insert a new line before the current line. | 


Change 
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Insert a new line after the current line. 


Replace existing text with the text you type. 


Replace a single character with the text you type. 


Substitute the current line with one you type. 


Substitute a single character with the text you type. | 
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The vi editor seems complex at first 

but it is actually somewhat easy to use. The 
tricky part is the fact that there 

are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


OPEN A NEW LINE OF TEXT EA type the letter o. 

ul Position the cursor to the & The vi editor switches to 
line above where you want to _ Input mode and opens a new 
insert a new line. blank line. 


The vi editor seems complex at first 
but it is actually somewhat easy to use. 
tricky part is the fact that there 

are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


®|* The INPUT MODE allows you to enter text 
directly into the document 


The modes are confusing at first.# 


If you don't know what mode you are in, you 
can press ESC a few times until vi beeps at 
you. 


3 Type the text you want to i The vi editor switches to 
insert. Command mode. 


4 Press Esc. 


DELETE TEXT IN VI 


ou can delete text from a file using keystroke 

commands. If you press the Delete key while in 

Command mode, this generates the symbols, “? 
which do not correspond to any command known to vi, and 
an error message appears. In Command mode, the Delete 
key has no function. You can use other keystroke 
commands to delete text. 


To delete content from your document, you must first move 
to the location of the unwanted text using the arrow keys or 
a movement command. Deletion commands use the 
current location of the cursor as the starting point of the 
deletion. 


You can delete the character underneath the cursor by 
typing a lowercase x. If there is more text on the line, it 
shifts to the left to fill the space formerly occupied by the 
deleted character. A capital X deletes the character to the 
left of the cursor. 


You can delete larger sections of text by typing the letter d 
and applying a movement command. For example, to delete 
from the current location to the beginning of the line, you 
can type d4, because the “ keystroke moves the cursor to 
the beginning of the line. To delete the current line, you can 
type dd. If you want to delete everything from the current 
position to the end of the current line, you can type either 
D or d$. A list of deletion commands appears in the table 
on the facing page. When you edit the text in your file, vi 
does not save your changes until you give the command to 
do so. 
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The 
pve part is the fact that there 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 
The modes are confusing ot first. 


If you don't know what mode you are in, you 
can press ESC a few times until vi beeps at 


DELETE CHARACTERS 


ui Position the cursor over 
the character you want to 
delete. 
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The vi editor seems complex ot first 
but it is actually some easy to use. The 
tricky part is the fact tl at there 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter tex 
directly into the document 
The modes ore confusing at first. 


If you don't know what mode you are in, 
can press ESC a few times until vi beeps lot 
you. 


The vi editor deletes the 
character. 


BB Type the letter x. 


WORK WITH TEXT EDITORS 


You can use these commands to remove text from the file you 
are editing. If you make a mistake, you can type the keystroke 
command u, which undoes the most recent change. You can 
use this command to undo insertions as well as deletions. 


KEYSTROKES EFFECT 
D Delete from current position to end of line. 
dd Delete current line. 


dG Delete from current position to end of file. 


dw Delete current word, from current position to end of word. 
a> Delete from current position to beginning of line. 

das Delete from current position to end of line. 

d/text Delete from current position to next occurrence of text. 
u Undo last command that changed the file. 


X Delete character to left of cursor. 


Delete character under cursor. 
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The vi editor seems complex at first “ The vi i_editor seems co plex at_first 
but it is actually somewat easy to use. The e ibut it is actually somewat easy to use. The 


igre two MODES: 


are two MODES: 
q * The COMMAND MODE lets you type commands 
* The COMMAND MODE lets you type commands : to move around 
to move around 
* The INPUT MODE allows you to enter tex 
* The INPUT MODE allows you to enter text ; directly into the document 
directly into the document : The modes are confusing at first. 
The modes are confusing at first. i 
If you don't know what mode you are in, sou 
If you don't know what mode you are in, you 
can press ESC a few times until vi beeps at 


DELETE A LINE OF TEXT 2 | Type dd. I The vi editor deletes the 


ul Position the cursor on the line. 


line you want to delete. 


EDIT TEXT WITH VI 


ou can edit text files using the multiline editing 

capabilities of the vi editor. While in Command 

mode, you activate the command line for editing 
purposes by first typing a colon (:). There are many useful 
commands that you can learn about, including the ex editor 
that provides the line edit commands. You can obtain more 
information from the vi manual by typing man vi or 
consulting online references or books about the vi editor. 


To replace text, you can use the substitute command by 
typing :s. When you type commands that begin with a colon 
(:), they appear on the bottom line of the Terminal window. 
vi carries out the command after you type the full command 
and press Return. 


There are many ways you can use the :s command, 
including: 
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but it is actually somewat easy to use. The 
are two MODES: 


* The COMMANO MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 
The modes are confusing at first. 


If you don’t know what mode you are in, you 
can press ESC a few times until vi beeps at 
you, 


(ae sls a i Ry 1 


£4 Type %s/ and the original 

Type : word or phrase you want to 
; replace. 

The cursor moves to 

the bottom of the screen 


following a colon. 


-” 


:s/old/new/ 
:s/old/new/g 
:%s/old/new/g 


The first instance replaces a single occurrence of old with 
new on the current line. The second instance adds the flag 
g, which stands for global. This means that vi replaces all 
occurrences of old with new on that line, and not just the 
first occurrence. The third instance includes a range option, 
%, which tells vi to replace all instances of the word 
throughout the entire file. 


To join two lines of text together onto one line, you can use 
the editing command J. This removes the line break at the 
end of the current line, and joins it to the next line. When 
you edit the text in your file, vi does not save your changes 
until you give the command to do so. 


@ Terminal file Edit Scroliback Font Window Help 
si Teeminal type. 
or first 

but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text 
directly into the document 
The modes are confusing at first. 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 


Es¢/the escape keW/g 


@ The vi editor globally 
replaces the old text with the 
replacement text. 


£3 Type a forward slash and 
the new word or phrase. 


4 Type another forward 
slash, the letter g, and press 
Return. 


You can cut-and-paste text in vi by using the 
deletion keystroke commands and the p 
command. When you delete text, it is not 
completely lost; instead, vi stores it in a paste 
buffer. You can think of this as a container that 
holds the most recently deleted text. 


You can paste the contents of the paste buffer 


by typing dd and move to the new location in 
the file. Type the letter p, and vi inserts the 
deleted line into the new location. 
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Oo Terminal — ttyp9 
The vi editar seems complex at first 

but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


fj The INPUT MODE allows you to enter text 
directly into the document 
The modes are confusing at first, 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 


JOIN TWO LINES OF TEXT EA Press Shift + J. 


EM Position the cursor to the 
first of two lines you want to 
join. 


into the current location of the cursor by typing precede the y or d keystrokes with a number. For 
the letter p. For example, to move a line, delete it | example, to yank 12 lines, including the current 


WORK WITH TEXT EDITORS 


You can copy text into the paste buffer without 
deleting it by using the y command, which stands 
for yank. As with deletion commands, you must 
follow the y with a movement command that 
indicates how many lines you want to yank, or you 
can type yy to yank the current line. 


To yank or delete a number of lines, you can 


one, type 12yy. 
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The vi editor seems complex at first 

but it is actually somewat easy to use. The 

are two MODES: 


* The COMMAND MODE Lets you type commands 
to move around 


The modes are confusing at first. 
If you don't know what mode you are in, you 


can press the escape key a few times until vi beeps at 
you. 


Ps  Sogad) ee is) Tn da 


The vi editor joins the two 
lines together. 


SAVE A FILE WITH VI 


hen you finish editing a file with the vi editor, you 

can save your work. It is a good practice to use 

the save command any time you make changes 
that you do not want to lose. To save the current file, you 
can type :w and press Return. vi saves the file to your hard 
drive, and any changes you make become permanent. The 
vi editor displays the filename, the number of lines, and the 
number of characters in the file after you save it. 


You can save the file with a different name by typing a 
filename before pressing Return. For example, to save the 
current file as my-update.txt, you can type :w my-update.txt 
and press Return. If you start vi without specifying a 
filename, you must remember to save with a new name, or 
else vi saves it in the /tmp directory with an arbitrary name 
such as vi.XWOhyP. 
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The vi editor seems complex at first 
but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE Lets you type commands 
to move araund 


* The INPUT MODE allows you to enter text directly inta the document 
The modes are confusing at first. 


If you don’t know what mode you are in, you 
can press the escape key a few times until vi beeps at 
you. 


Pt tee 


toms toe J ¢ 


SAVE A FILE WITH VI r4 Type the letter w and 


Tl Type :. press Return. 


a @ The vi editor saves the file. 


the bottom of the screen 
following a colon. 


om” | 


You may name your text file whatever you like, but for 
compatibility with Aqua applications, you should append 
text files with the file extension .txt. However, if you are 
creating a specific type of text file, such as an HTML file, a 
Cascading Style Sheets file, or an XML settings file, you 
must save it with the appropriate extension such as .html, 
.css, or .plist. 


To exit the vi editor, you can type the quit command as :q. 
You can combine the :w and :q commands together as 
:wq, which saves the file and exits the vi editor, returning 
you to the shell. If you have made changes but do not want 
to save them, you can exit vi by appending an exclamation 
point (!) to the :q command. 
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The vi editor seems complex at first 

but it ts actually somewat easy to use. The 
are two MODES: 


Window Heip 


* The COMMAND MODE Lets you type commands 
to move around 


* The INPUT MODE allows you to enter text directly into the document 
The modes are confusing at first. 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 
you, 


cP eee ea 


bad-tutorial . txt# | 


SAVE WITH A DIFFERENT 


<j} Type a new filename and 
FILENAME 


press Return. 


@ The vi editor saves the file 


PA Type the letter w and a under the new name. 


space. 


WORK WITH TEXT EDITORS 


One file you may want to edit is the .exrc file. This is a file 
that you store in your Home directory and that vi editor 
reads when it starts up. vi automatically runs the commands 
in the file, so this makes it a good place to store your 
preferred editor options, such as showmode. Because the 
filename starts with a period, it is a hidden file, invisible to 
the 1s command, but you can still list it by typing Is -a. 


EXRC File Example: 

set autoindent 
ruler 
verbose 
showmode 


To use these settings, make sure you are in your Home 
directory by typing cd, and then type vi .exrc. Enter the lines 
above into the file, save it, and exit. The next time you start 
vi, it automatically applies these options. 
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The vi editor seems complex at first 
but it ig actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


The vi editor seems complex at first 
but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE Lets you type commands 
to move around 


* The INPUT MODE allows you to enter text directly into the document i * The INPUT MODE allows you to enter text directly into the document 


The modes are confusing at first. 


If you don't know what mode you are in, you 


The modes are confusing at first. 


If you don't know what mode you are in, you 


can press the escape key a few times until vi beeps at H can press the escape key a few times until vi beeps at 


you. 


ri aes es Via tila Halas 


ou. 


jE ses es ee ae 


3 

SAVE AND EXITVi KJ) Type wq and press Return. | EXITVIWITHOUTSAVING sf The vi editor exits without 
El Open a file and add W@ The vi editor saves the file [Ml Type :. =2V INE: 

some text. and exits. 


74 Type :. 


74 Type q! and press Return. 


OPEN A FILE WITH EMACS 


is a very complex program that can do everything 
from editing simple text files to downloading and 
displaying Web sites. 


Y: can use the emacs editor to edit text files. emacs 


Among advanced Unix users, there is a friendly rivalry 
between users of vi and users of emacs. This book gives 
greater coverage to vi because it is less complex than 
emacs. However, if you do not find vi to your liking or you 
prefer to use a very flexible and adaptable text editor, the 
emacs editor is an excellent choice. 


The basic functions of the emacs editor are easy to use. To 
open a file, you can simply give the name of the file as an 
argument, as with other text editors. Unlike vi, emacs does 
not have different modes for Command and Input, so you 


do not have to switch between modes as you would with vi. 


As with Pico, you can use the arrow keys to move around, 
and you can edit text directly. 


You can execute commands in emacs by using either the 
Control or Meta key. When you type a character with the 
Control key, this corresponds to the prefix C- in emacs 
terminology; a character that you type with the Meta key 
corresponds to the prefix M-. For example, to search for 
text, you press Control + S (C-s), and to move to the end of 
a file, you press Esc + > (M->). Keep in mind that the prefix 
C- means that you must hold down the Control key while 
pressing another key, and M- means you must press and 
release the Esc key before typing the following key. You use 
the Esc key instead of the Meta key because Apple 
keyboards do not have a Meta key. 


OPEN A FIILE WITH EMACS 
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Se 


ser [emacs |bad-tutorial.txt J 


OPEN A FILE WITH EMACS 


EJ Type the name of the file 
and press Return. 


EW Type emacs and a space. 


Scroliback 
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but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE Lets you type commands 
to move around 


#}/* The INPUT MODE allows you to enter text directly inte the document 


The thodes are confusing at first. 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 


or information about the GNU Project and its goa Ss, type C-h C-p. 


i Fl | bad-tatoerial, txt Text) | 


Mi The emacs editor displays 
the file. 


This area displays the 
document. 


@ This area displays the 
filename. 


i This area displays the 
status line. 


WORK WITH TEXT EDITORS 


The following table is a summary of some of the most 
useful emacs commands for moving and finding text. 


KEYSTROKES COMMAND NAME EFFECT 
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but it is actually somewat easy to use. The } but it ts actually somewat easy to use. The 
are two MODES: i are two MODES: 


* The COMMAND MODE lets you type commands i * The COMMAND MODE lets you type commands 
to move around : to move around 


* The INPUT MODE allows you to enter text directly into the document ' * The INPUT MGDE allows you to enter text directly into the document 
The modes are confusing at first. : The modes are confusing at first. 


you don't know what mode you are in, you ; 
can press the escape key a few times until vi beeps at i If you don't know what mode you are in, you 
you. | can press the escape key a few times until vi beeps at 


bad= tutorial. txt 


INSERT TEXT IN EMACS 4 Type your text directly Mi emacs adds the text to the 
PS easton the cumsenwherc into emacs. file at the insertion point. 


you want to insert text. 


EDIT A FILE WITH EMACS 


ou can edit and save text files in emacs with 

keystroke commands that use the Control and Meta 

keys. You can also configure the Terminal application 
to allow the Option key to function as the Meta key. 


There are literally hundreds of emacs commands that you 
can use, and you can even add additional extensions to 
emacs to increase this number. Many of the more esoteric 
commands in emacs are only of interest to serious Unix 
users. As a beginning user, you may want to type C-h t to 
read the emacs tutorial. To do this, you hold down the 
Control key and type the letter h, then release the Control 
key and type the letter t. 


A short list of commands that let you edit your files appears 
on the facing page. As with other text editors, emacs does 
not make your changes permanent until you save the file. 


To make it easier to type Meta keystroke commands, those 
indicated by the M- prefix, you can configure the Terminal 
application to use the Option key. You can activate this 
Window setting from the Terminal menu. It allows you to 
type Meta keystrokes by holding down the Option key 
while pressing the appropriate key, instead of pressing and 
releasing the Esc key before the following key. 


You can also get emacs to recognize and work with your 
mouse, a capability that most shell applications do not 
possess. To do this, you enable the Terminal Window setting 
named Option click to position cursor; when you hold 
down the Option key and click your mouse, emacs moves 
the cursor to the current position of the mouse pointer. 


EDIT A FILE WITH EMACS 
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are two MODES: 


* The COMMAND MODE lets you type commands 
to move around 


* The INPUT MODE allows you to enter text directly into the document 
The modes are confusing ot first. 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 
you, 


t AP “ Tor + 
Fl pad-tutorial txt 


—* | 2] Press Control + S. 


EI Press Control + X. The emacs editor saves 


your file. 
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The vi editor seems complex at first 
but it is actually somewat easy to use. The 
are two MODES: 


* The COMMAND MODE Lets you type commands 
to move around 


* The INPUT MODE allows you to enter text directly into the document 
The modes are confusing at first. 


If you don't know what mode you are in, you 
can press the escape key a few times until vi beeps at 
you. 


fl bad<tutorial txt 


iferro:~] user’ § SSS 


EXIT EMACS 
4 Press Control + X. 
2 Press Control + C. 


M The emacs editor exits and 
returns you to the shell 
command line. 


WORK WITH TEXT EDITORS 


The table below contains some emacs commands that you can use to edit 
text files and save your changes. 


KEYSTROKES COMMAND NAME ~ EFFECT 


Delete char Delete the current character. 

Delete the current line, current position to end of line. 
Transpose chars Transpose, or switch, two characters. 

Save buffer, kill emacs 

Find file Open a new file for editing. 

Save file Save the file. 

Transpose lines Transpose, or switch, two lines. 

Write file Save the file under a different name. 

Undo Undo the last change to the file. 

Query replace Find and replace text, type y to confirm. 


Transpose words Transpose, or switch, two words. 


Keep in mind that the prefix C- means to hold down the Control key while 
pressing another key, and M- means you must press and release the Esc key 
before typing the following key. You can also hold down the Option key to 
type M- keystrokes, if you have enabled the correct Terminal setting. 


Ts BRGEeme Fite Edit Scroliback Font Window Help 
q :O 


re) g About Terminal j Telminal inspector 


[ @ Terminal File Edit Scrollback Fant Window Heip 
2. 4 5 & 


3 
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(fert preferences... 
Window Settings... 


Services 


: £9 Delete key sends backspace 
fits ooton kay as mata hey 
4 Ml Option click to position curser 
fi Paste newlines as carriage returns 
€2 Serer 1-100 keypad! behavior 
(2) Escape 6-A chars with Cirl-v 
GE Reverse tnewrap 


Hide Terminal 
Hide Others : 
Show All : 


Paste newlines as carriage returns 
_ ptriet VJ-100 keypad behavior 
3 Escape &-bit chars with Curl-V 


Qutput Options: 
‘(audible nett’ 


CONFIGURE TERMINAL 
TO WORK WITH EMACS 


EH Click Terminal © Window 
Settings. 


@ The Terminal Inspector Click the Use option key EH Click the red Close 
window appears. as meta key check box. button to save your 
preferences. 


74 Select Emulation from the Click the Option click to 
drop-down menu. position cursor check box. i The Terminal now uses 
the Option key as a Meta 


key. 


SET YOUR PROMPT 


special shell variables. Changing your prompt lets you 
customize the information that the prompt displays 
to better suit your needs. 


Y> can change your command line prompt by setting 


The prompt lets you know that you are entering text into 
the shell, rather than a program. When it reappears, this 
tells you that the last command has finished executing. You 
can set your shell prompt to contain whatever information 
you like using the following command: 

set prompt = ‘prompt formatting sequence' 
A prompt formatting sequence is a series of letters, 
symbols, and special character codes that serves as your 
prompt. A list of the most useful special formatting codes 
appears on the facing page. 


The default prompt is set to the name of the computer, the 
partial path, and your short username. This is useful on a 


multi-user system, or if you frequently log on remotely to 
other computers. However, many users are only on one 
computer at a time — the one they are sitting in front of — 
and only as a single user. If this is true for you, you may 
want to set your prompt to the time, the number of 
commands entered, or the full path. 


In addition to the shell command prompt, you can set 
several other prompts. You use the prompt2 setting if you 
end a command line with a backslash (\), indicating that the 
current command continues on the next line. You see the 
prompt3 message if you have auto correction on for 
misspelled commands. You see the rprompt message on 
the right side of the Terminal window for every command. 


Prompt settings only last as long as the Terminal window in 
which they are set is open. To make them permanent, see 
"Edit Your .tcshrc File" in this chapter. 


SET YOUR PROMPT 
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CHANGE THE DEFAULT PROMPT 2 Type a prompt formatting 


sequence in single quotes, 


Type set prompt = and a and press Return. 


space. 
The prompt changes. 


SET THE SECOND PROMPT 


Ferminal File Edit Scrollback Font Window Help 


| 17) - (eee eee St 
Ci:@6am #18) shareX|set prompt2 = 
1:06am _ #19) share® cd \ 


Jwhat_else?|~ 


Ci:@6am #20) ~% fj 


~4 Type a prompt formatting 
sequence in single quotes, 


41 = 
Type set prompt2 = and a and press Return. 


space. 
The second prompt 


80 changes. 


CUSTOMIZE YOUR SHELL 


set prompt = '[%m:%c3] %n%# ' is the standard 
shell prompt in Mac OS X. The formatting Code table 
explains the meanings of these and other special codes. 


FORMATTING CODE EXAMPLE MEANING 


a | aN Yer see 
a (Ge 


This is the 14th command. 


The short name of the computer. 
fuser | Yourshort username, 
[bee | The month of the year 
The % symbol, # if you are root. 
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€1:09am #37) ~% my-dog.jpg Pictures/ 
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SET THE THIRD PROMPT 


74 Type a prompt formatting 
sequence in single quotes, 
and press Return. 


us Type set prompt3 = and a 
space. 
8 The third prompt changes. 


SET THE RIGHT-HAND PROMPT 
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Pictures i 
Public ‘ 
<-~ user@ferro | 
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2 Type a prompt formatting 
sequence in single quotes, 
and press Return. 


il Type set rprompt = and a 
space. 
The right-hand prompt 
changes. 


SET COMMAND ALIASES 


ou can save time and reduce typing by setting short 

aliases for long commands. You can use the alias 

command to define and list aliases. To create a new 
alias, you can use a command line like this: 


alias short-alias ‘longer command’ 


One commonly used alias is 11, which most Unix users 
define with the following command: 


alias 11 ‘ls -l' 


This alias allows you to type 11 as a command and have it 
execute the 1s -1 command, which shows a long listing. 
You can insert additional arguments, such as a directory, 

after the 11 command just as you can with the original 1s 


As a result, all of your rm commands automatically include 
the -i option. 


If you redefine a command, such as the rm command, using 
an alias, and you need to use the original version, not the 
alias, you can do so by typing a backslash (\) before the 
command name. This bypasses aliases and invokes an 
executable program in your path or a shell built-in 
command. 


To list all of your aliases, you can type alias without any 
arguments. If you need to remove an alias, you can use the 
unalias command. 


Like other shell settings, your aliases only remain as long as 
your Terminal window is open. You can make your aliases 


-1 command. permanent by saving them in your .tcshrc file. See "Edit 


Your .tcshrc File" in this chapter. 
You can also redefine existing commands to be aliases. For 
example, if you are afraid that you may mistakenly delete an 
important file because you do not always remember to use 
the -i option with the rm command, you can set an alias as 
follows: 


alias rm ‘rm -i' 


SET COMMAND ALIASES 
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12 user :12 Desktop 
6 user 132 Documents 
2 user :@8 Images 
22 user :4@ Library 
:49 Movies 
:49 Music 

:@9 Pictures 
749 Public 
:49 Sites 


drwxr-xr-x 4 user 


drwxr-xr-x 8 user 
drwxr-xr-x 2 user 


SET COMMAND ALIASES <3 Type a long command in 


single quotes and press 
Return. 


Type the short alias with 
any appropriate arguments 
and press Return. 


i The shell executes the long 


uli Type alias and a space. command. 


Type a short alias. 


CUSTOMIZE YOUR SHELL 


Most advanced Unix users like to avoid typing 
unnecessary characters, and thus make extensive use of 
the alias command. Some of the most common and 
useful aliases appear in the following table. You can save 
these aliases by storing them in your .tcshrc file. 


SHORT ALIAS LONG COMMAND DESCRIPTION 
pushd Always maintain the directory stack. 
In case you forget the space. 


4 cd.. 
Sst 
home fed~ ____| Return to Home directory 


Long file listing. 


Prompt for each file deletion. 


Change directory to the parent directory. 


x ‘Terminal File €dit Scroftback font Window Help % Terminal File Edit Scroiiback font Window Help 
OO ae bc —- d , n 
| Pprecro:<] users bd 
i Is -1 ferro:~] user® iL 


LL: Command not found, 


{ferro:~] user® 


{ferro:~] userx jj 
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LIST ALL CURRENT ALIASES 


74 Type alias, a space, then DELETE AN ALIAS Z4 Type the name of an alias 


Ell Type alias and press an alias, and press Return. and press Return. 


Return. 


ull Type unalias and a space. 
The shell lists the long i The alias is no longer 
command for that alias. defined. 


The shell lists all aliases. 


SET SHELL VARIABLES 


ou can affect the way your shell functions by setting 

shell variables. A shell variable can either have a value 

or it can have no value — in which case the value is 
null. You can think of shell variables without values as 
simple on-or-off switches. If the variable is set, the shell 
functions as if the switch is on. If the variable is not set, the 
switch is off. 


A shell variable with a value, on the other hand, acts like a 
blank line on an application that you can fill with the 
correct information. If you are applying for a job, for 
example, there is a line labeled Name on the application 
where you fill in your name, and another labeled E-mail 
where you write your e-mail address. 


To set a variable, you use the set command: 


set variable 


set variable = ‘value’ 


The first example sets the variable without giving it a value; 
it simply sets the switch to on. The second example sets the 
variable to a value, like filling in the blank on a job 
application. 


If you type set by itself on a line, you see the list of your 
current shell variables. The shell automatically sets many of 
these either when you start up the Terminal window or 
when you type commands. In addition to these automatic 
variables, you can set a number of other variables that 
affect how your shell works. These appear in the table on 
the facing page. 


Shell variables normally last as long as the Terminal window 
is open, although you can use the unset command to get 
rid of shell variables beforehand. To make your shell 
settings permanent, see "Edit Your .tcshrc File" in this 
chapter. 


SET SHELL VARIABLES 


| @ Terminal file Edit Scroilback Font 


2 eee 


Window Help 


/Users/user 
dirstack /Users/user 
echo_style bsd 
edit 
gid 
group 


2@ 
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history 108 
home /Users/user 


v7 


promptZ %R? 

prompt3 CORRECT=#R Cylniela>? 
promptchars SH 

shell /bin/tcsh 


LIST CURRENT 


This is an example of a 
SHELL VARIABLES 


Shell variable with no value. 


il Type set and press Return. This is an example of a 


§ The shell displays all shell Shell variable with a value. 


variables. 
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Window Help 
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addsuf fix 
argy O 


cwd /Users/user 
dirstack /Users/user 
echo_style bsd 

edit 

gid 26 

group staff 

history 100 


home /Users/user 


prompt (%n:%c3] swe 
prompt2 %R? 
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promptchars %H 


SET A SHELL VARIABLE P34 Type a variable name and 


Type set and a space. press Return. 


The shell variable is set but 
has no value. 


CUSTOMIZE YOUR SHELL 


You can set any variables you want, as long as their names start 
with a letter and contain only letters, numbers, and the underline 
symbol. However, these variables only affect the shell if their name 
corresponds to the list of special variables understood by the shell. 
Some of the most useful special variables appear in the table below. 


VARIABLE SAMPLE VALUE MEANING 


No value Correct command mistypings. 
30 Exit the shell after 30 minutes of no activity. 


enhance Use improved, case-insensitive, tab completion. 


No value Remove duplications in the pushd directory stack. 
15 


Show last 75 command lines. 


No value Shell commands do not beep at you. 


No value Redirection does not overwrite existing files. 


(/bin /usr/bin) | Your path. 
No value Flash the Terminal window instead of beeping. 


There are a number of variables that are automatically set by the shell 
such as version, uid, user, shlevel, term, and home. You should 
not change shell variables unless you know what effect they produce. 
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= unset complete 


addsuf fix 
argv QO 

cwd /Users/user 
dirstack /Users/user 


addsuf fix 


dirstack /Users/user 
echo_style bsd 


echo_style bsd edit 

edit gid 28 

gid 28 group = staff 

group staff history 100 ; 
history 100 home /Users/usen t 
home /Users/user loginsh i 
loginsh neclobber i 
noclobber owd 


owd 
path C/bin /sbin /usr/bin /usr/sbih) 
prompt [xm:%c3] ¥nke 
Pprompt2 ®R? 

prompt3 CORRECT>&R (ylniela)? 


path C/bin /sbin /usr/bin /usr/sbih) 
prompt [Xm:%c3] X%nKe 
prompt2 XR? 

Pprompt3 CORRECT>R Cyiniela)? 
promptchars Set 


SET THE VALUE OF A SHELL <4] Type a variable value in 


quotes, and press Return. 


UNSET A SHELL VARIABLE ~4 Type a name of a variable 


and press Return. 


iB Type set and a space. i Type unset and a space. 


The shell variable is unset. 


i The shell variable is set to 
the value. 


74 Type a variable name 
followed by an equal sign (=). 


SET ENVIRONMENT VARIABLES 


ou can change values that applications inherit by 

setting environment variables. Environment variables 

are similar to shell variables. Any command that the 
shell runs can access environmental variable settings; the 
environment variables represent the environment in which 
you run commands. Depending on the command, the shell 
may or may not use an environment variable to affect the 
execution of the command. 


For example, if you type a V in less, the less command 
uses the EDITOR environment variable, so that you can edit 
the file that displays. To set an environment variable, you 
use the setenv command: 


setenv VARIABLE 
setenv VARIABLE ‘'value' 


The first example sets the variable without a value, that is, 
with a null value, and the second example gives a value to 


the variable. Note that unlike the set command, the 
setenv command requires no equal sign. You should type 
environment variable names in all capital letters to 
distinguish them from shell variables. 


You can get a listing of the current environment variables 
and their values by typing the printenv command. If you 
compare this listing to that of shell variables — viewed by 
typing set — you can see that there is some duplication. 
Pairs of variables such as HOME/home, TERM/term, and 
SHLVL/shlv1 have the same names and values. This 
duplication allows the values to be accessed by the shell as 
well as by commands run within the environment of the 
shell. These variable pairs automatically link so that 
changing one changes the other. 


If you need to unset an environment variable, you can use 
the unsetenv command. Your environment variables last 
only as long as the current Terminal window is open, unless 
you save the setenv commands in your .tcsrhc file. 


SET ENVIRONMENT VARIABLES 
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HOME=/Users/user 

SHELL=/bin/tesh 

USER=user 

LANG=en_US 
PATH=/bin: /sbin: /usr/bin:/usr/sbin 
__CF_USER_TEXT_ENCODING=OxiF8 : 0: 


TERM_PROGRAM=AppLe_Terminal 
TERM_PROGRAM_VERSTION=81 
LOGNAME=user 
HOSTTYPE=macintosh 
VENDOR=apple 
JOSTYPE=dorwin 
WMACHTYPE=powerpe 


Sitter aed cal 
| GROUP =staFt 
WHOST=ferro. local. 


[ferro:~] user’ §f 


LIST CURRENT ENVIRONMENT 


i The shell displays all 
VARIABLES 


current environment 


Ll Type printenv and press variables. 


Return. 


ferro:~] user® 
{ferro:~] user% printenv 
HOME=/Users/user 

SHELL=/bin/tcsh 

USER=user 

LANG=en_US 
PATH=/bin: /sbin: /usr/bin: /usr/sbin 
—CF_USER_TEXT_ENCODING-OxiF8:@:@ 
TERM=vt100 

TERMCAP= OD 
TERM_PROGRAM=App1le_Terminal 
TERM_PROGRAM_VERSION=&2 

LOGNAME=user 

HOSTTYPE=macintash 

VENDOR=apple 

OSTYPE=darwin 

MACHTYPE=powerpc 

SHLVL=1 

PWO=/Users/user { 
GROUP=staff 

HOST=ferro. local. 

JARBITRARY= | 


SET AN ENVIRONMENT 


J Type an environment 
VARIABLE 


variable name and press 
Return. 


Ll Type setenv and a space. 


The shell sets the 
environment variable, but 
with no value. 


CUSTOMIZE YOUR SHELL 


Applications are the primary users of environment variables. This means that each 
application may have a different set of environment variables that it looks for in 
order to affect its operation. To know which environment variables to set, you must 
consult the documentation for the programs you use. You can usually find this 
information on the manual page by using the man command. 


Some environment variables are standard and are understood by many programs. 
Some of these are listed in the table below. Those marked with a plus symbol (+) 
are set by the system and should generally be left unchanged. 


VARIABLE SAMPLE VALUE MEANING 


Sebi ( 


vt100 The Terminal application emulates a vt100. 
USER (+) Your short username. 


VISUAL Your preferred text Bator 
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(ferro:~] user® printeny - (ferro:~] userk® 
HOME=/Users/user > 
SHELL=/bin/tcsh 

USER=user 

LANG=en_US 

PATH=/bin: /sbin: /usr/bin: /usr/sbin 

__CF_USER_TEXT_ENCODING=@x1F8:0:@ 

TERM=vt100 

TERMCAP=@ @@ 

TERM_PROGRAM=App Le_Terminal 

TERM_PROGRAM_VERSTON=81 

LOGNAME=xuser 

HOSTTYPEsmacintosh 

VENDOR=apple 

OSTYPE=darwin 

MACHTYPE=powerpc 

SHLYL=4 

PWD=/Users/user 

GROUP=staff 

HOST=ferra. Local . 


SET THE VALUE OF AN E] Type a value in single UNSET AN ENVIRONMENT £4 Type the name of an 


ENVIRONMENT VARIABLE __ quotes and press Return. Ail... |” eee environment variable and 

i fi Type setenv and a space. Theshell siete uw Type unsetenv and a press Return. 

FE] Type the name of an environment variable Peee Mi The environment variable 
environment variable and a to the value. is unset. 

space. 


SET YOUR PATH 


searches for commands by setting your path variable. 
Changing your path is necessary if you install new 
command-line software on your computer. 


Y=: can change the directories where the shell 


The default path includes the directories /bin, /sbin, 
/usr/bin, and /usr/sbin because they are where Mac OS X 
stores the programs that come with the system. If you add 
new programs, they may install into other directories such 
as /usr/local/bin, /usr/local/sbin, or /sw/bin. lf you do not 
change your path, then the only way to run those programs 
is to type out the full pathname before each, as in 
/usr/local/bin/vim filename. 


You can set your path by typing out a list of pathnames in a 
set command. Because you are providing a list, you should 
use parentheses instead of single quotes. For example: 


set path = (/bin /sbin /usr/bin /usr/sbin 


/sw/bin) 


This command immediately updates your path as well as 
the PATH environment variable. When you type the 
filename, it locates any executables stored in the new path; 
you can use the which command to confirm this. 


If you already have a long path value, it may be difficult to 
retype or copy-and-paste the current path value. Instead, 
you can add new directories to the path by typing: 


set path = ($path /new-directory) 


$path tells the shell to insert the current value of the path 
variable before setting the value. You type the pathname of 
the new directory after $path to append it to your path. 


Because path is a shell variable, any value that you set lasts 
only while the current Terminal window is open. To make 
the changes to your path permanent, you can store the 
command to set the path in your .tcshrc file. 
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809 ee eee 

erro.~] user%|set path =[C /bin /sbin /usr/bin /usr/sbin /sw/bin a 
[ferro:~] user% which emacs ; 
, /sw/bin/emacs 


SET PATH TO DIRECTORY LIST F4 Type a list of directories 


within parentheses and press 


1 = 
Type set path = and a eunes 


space. 
The shell sets your path to 
the directory list. 


SN 4 


(ferro:~] user® 


APPEND TO YOUR PATH £4} Type a list of directories 


and a right parenthesis, and 
press Return. 


The shell adds the new 
directories to your path. 


ull Type set path = and a 
space. 


FJ Type a left parenthesis, 
$path, and a space. 


5 


CUSTOMIZE YOUR SHELL 


EDIT YOUR .TCSHRC FILE 


aliases, your shell variables, your environment 
variables, and your path so that each time you open 
Terminal, your shell is configured to your preferences. 


Vi can save the commands to set your prompt, your 


You save these commands in a special file called .tcshre that 
you create in your Home directory. The period, or dot, at 
the beginning of the name indicates that the file normally 
hides from the Mac OS X Finder and from the 1s 
command, although you can still list it using the -a option 
with the 1s command. It is common for Unix programs, 
such as the tcsh shell, to store their configuration settings in 
invisible dot-files in your Home directory. These files begin 
with a period and often end in rc. 


The tcsh shell executes all commands in your .tcshrc file 
whenever you open a Terminal window or start a shell. To 
create your .tcshrc file, you can use any text editor, including 
Pico, vi, or emacs, and enter one command per line. 


EDIT YOUR .TCSHRC FILE 


You can also use the example tcsh files that are located in 

the /usr/share/tcsh/examples directory on your computer. 
You can add a line at the very beginning of your .tcshrc file 
as follows: 


source /usr/share/tcsh/examples/re 


The source command tells the shell to read the commands 
from a text file and run them as if they are being entered 
directly into the Terminal program. As a result, this 
command in your .tcshrc file tells the shell, upon starting, to 
run the commands stored in the /usr/share/tcsh/examples/ 
rc file. For more information, you can type less /usr/share/ 
tcsh/examples/README. You can also store your aliases, 
variables, and environment variables in separate files as 
described in the README file, although it is acceptable to 
set them all within your .tcshrc file. 
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80° a ee 


5 ca ee 
erro:~] user® I 


LB Type cd ~. 


<3 Type .teshre and press 


: Return. 
@ This takes you to your 
Home directory. i The text editor opens the 


EF Type the name of a text file for editing. 


editor command and a space. 
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alias print ‘lpr’ 

set noclobber 

setenv EDITOR ‘/us-/bin/pico’ 

set path = (/bin /sbin /usr/bin /usr/sbin /usr/local/bin /sw/bi 


mai Type the commands to set 
your preferences. 


@ When you start a new 
Terminal window, the shell 
executes the commands in 


Jy} Save the file, and exit the the .tcshrc file. 


editor. 


RECALL YOUR COMMAND HISTORY 


by using the history command. You can also use 
special characters to repeat or edit commands you 
have already typed. 


y ou can list the commands that you have typed before 


The history command lists the commands you have typed 
since opening this Terminal window, along with the time at 
which each command was run. The history command 
lists the 100 most recent commands, provided that you have 
typed more than 100 commands into the current Terminal 
window. 


You can repeat commands or portions of commands using 
the history recall built into the shell. You do this by typing 
an exclamation point (!), or bang, followed by a special 
code that indicates what information from your history you 
want to recall. There are a number of different history 
codes that you can use, the simplest being two exclamation 
points (! !); this code repeats the last command that you 


typed. If you type an exclamation point and then some 
letters, the shell searches through the command history for 
the most recent command beginning with those letters, and 
repeats that command. In both cases, the shell displays the 
recalled command immediately before executing it. A list of 
other history codes appears on the facing page. 


You can also edit the previous line by using a caret (*). This 
is a method to correct a mistake you may have made, or to 
change a command so that it applies to different files. You 
use the caret as follows: 


“old-text*new-text 


The command is repeated, but with the o/d-text replaced 
by the new-text. For example, if you have just typed cd 
/usr/shrae and you want to correct yourself, you can type 
AshraeAshare and press Return. 


RECALL YOUR COMMAND HISTORY 
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mv my-dog.jpg . 
cd ../Images/ 
Ls 


LIST COMMAND HISTORY 


I The shell lists all the 
commands you have typed 
into the current Terminal 
window. 


EM Type history and press 
Return. 


| 
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REPEAT THE LAST COMMAND 


ml Type !! and press Return. 


@o8 coe Terminal — ttyph ™ 
[ferro:~/Images] user% 1s ~1 my-dog. jpg & 
“Pir none luser staff 25762 Nov 18 15:13 my~dog. jpg r 


The shell displays the 


previous command. 


The shell executes the 


previous command. 


The table below lists some of the most useful history 
codes. You can use these history substitutions anywhere 
in your command line. For example, if you have just 
moved a series of files with the mv command and you 
want to change their file permissions, you can type chmod 
+r !!* to use the chmod command on the arguments 
supplied to the mv command that you have just executed. 


HISTORY CODE MEANING 


The previous command. 


The argument of the previous command. 


The first argument of the previous command. 


CUSTOMIZE YOUR SHELL 


__§ 


The last argument of the previous command. 
The last command beginning with text. 


The last command containing text. 


The command number from the history command. 


The command three commands ago. 


Terminal File Edit Scrollback font Window Help @ Terminal File £dit Seraliback Font Window Help 


PSP a OSS TPP DOPE DADO TREO Aart eos ttt ede AE aOR CDRS ATO 


(ferro:~/Documents/To Do Lists] user® history a “Si 
19 1:35 cd r grap: Command not found. f 
2@ 1:35 cd Documents i Ferro:~/Documents/To Oo Lists] userx |Agraphgrep| 
ai 35 86s ; 
Ze. Av3aS cd “To Do Lists" i keep 
23. 1°35 is : keepable 
24 1:35 we priorities.txt : keeper 
25, 1:35 we k-words, txt i keeperess 
25-2335 grep -i *Aky' k-words txt £ keepering 
ZY 3-36 6 US i ! keeperLess 
28 1:36 history t keepership 
ferro:~/Documents/To Do Lists] users [ihec| i keeping 
; keepsake 
2226 222@ =618874 k-words.txt H keepsaky 
(ferro:~/Documents/To Do Lists] user% fj F keepworthy 
H [ferro:~/Documents/To Do Lists] user® | 
be 
(+ 
REPEAT A SPECIFIC COMMAND __ The shell executes the THe hae ahi a IN 4 Type “ and the corrected 
Ml Type ! most recent command that portion of the command. 
2 Type the first few letters of press Return. : 
a previous command and > Cee omer i The shell executes the last 
press Return. ype Sana’ tie misty pe command with the correction 


portion of the command. 


in place. 


UNIX FOR MAC 


START A NEW SHELL 


the shell. Running commands in a sub-shell can 
preserve your shell settings or allow you to use a 
different shell program. 


Vi can start another shell by typing the pathname of 


Each time you start a new shell, it executes the commands 
stored in your .tcshrc file — or the appropriate dot-file for 
the shell if it is not tcsh — and gives you a new prompt. 
Most shell variables are set to their initial default values, but 
environment variables remain set with any values they had 
in the original shell. 


When the new shell starts up, it has a clean command 
history. If you type history, you see a very short list that 
does not include any of the commands executed in the 
original shell. Likewise, after you exit the new shell, the 
command history for that shell does not appear in the 
history of the original shell. You only see the command to 
start the newer shell. 
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ok re 


Trento eR 
bash-2.@5a$ ff] 


START A SHELL PROCESS A new shell process starts. 


Ei Type the full pathname of 
a shell you want to start. 


EXIT THE NEW SHELL 


If you are done using a new shell, you can close it by typing 
the exit command. This returns you to your original shell. 
If you changed your current directory in the new shell, you 
find yourself back in the original directory when the new 
shell exits. 


Mac OS X comes with three shells installed. The tcsh shell is 
the default, and the one that this book assumes you are 
using. The Bourne-again shell, known as bash, is a popular 
alternative to the tcsh. The Z shell, zsh, offers many 
customization opportunities for Unix power users. The 
pathnames for these shells, respectively, are /bin/tcsh, 
/bin/bash, and /bin/zsh. For more information about the 
bash and zsh shells, see "Work with the Bourne-Again 
Shell” and "Work with the Z Shell" later in this chapter. 


= es a | 
bash~2,@Sa$ cd Pictures/ 

bash-2.@5a$ 1s -1 

total 200 

-rw-r--r-- louser staff 23287 Dec 2 02:1 
-rw-r--r-~ Jouser staff 21614 Dec 2 02:11 wwnkd_@30.gif 
~tw-P--r-- luser staff 25167 Dec 2 02:11 wenkd_031.g9if 
~(W-P--r-~- louser staff 23046 Dec 2 02:11 wmkd_032.gif 
bash-2.@5a$ cd .. 

bash-2.25a$ pwd 

/Users/user 

bash-2.@5a$ which pwd 

/bin/pad 

bash-2 .5a 

exit 


1 wenkd_@29. gif 


The shell exits, returning 


rH Type exit and press you to your original shell. 


Return. @ The path remains what it 
was before you started the 


new shell. 


CHANGE YOUR SHELL 


CUSTOMIZE YOUR SHELL 


ou can change your default shell from tcsh to bash 
Y or zsh, so that the Terminal program automatically 

starts with your preferred shell. You may never want 
to change your shell; the tcsh shell is a very useful and 
user-friendly shell program. However, many people like 
the bash shell, especially those from a Linux background, and 
you may wish to use that shell instead. For more information 
about the different shells, see "Work with the Bourne-Again 
Shell" and "Work with the Z Shell" later in this chapter. 


Changing your shell is a two-step process. The first step is 
to use the chpass command to change your shell record in 
the master password file. You can update this file, which is 
located at the pathname /etc/master.passwd, by typing the 
following: 


chpass -s /path/to/shell 


For example, chpass -s /bin/zsh makes your default shell 
the Z shell, and chpass -s /bin/bash changes your default 
shell to the Bourne-again shell. 


After you update the master password file, you need to 
enter the changes into the NetInfo database. NetInfo is a 
database maintained by Mac OS X for keeping track of 
many things related to the operation of your computer, 
including default shells. To make your shell change take 
effect in NetInfo, type the following command exactly as it 
appears here: 


sudo cat /etc/master.passwd | sudo niload -m 
passwd / 


This example uses the sudo command to allow you access 
to files and permissions you normally would not be able to 
change. For this reason, you must make sure that you do 
not make a mistake typing the command. After you press 
the Return key, you see a prompt asking you to enter a 
password. At this point, you can enter your normal user 
password and press Return. 
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ec6e |_| Terminal — tvps 
{ferro:~] user% /bin/zsh 


chpass: rebuilding the database... 
chpass: done 

chpass: /etc/master.passwd: unchanged 
[ferro:~] user% ff 


Ell Type chpass -s and a 
space. 


The chpass command 
updates the master password 


r4 Type the full pathname to ike 


a shell and press Return. 


[ferro:~] user® chpass -s /bin/zsh 
chpass: rebuilding the database... 
chpass: done 

chpass: /etc/master.passwd: unchanged 


%|sudo cat /etc/master.passwd | sudo mitoad -m passwd / 


Type the command to 
update the NetInfo database 
and press Return. 


@ This command updates the 
NetInfo database, and 
changes your shell. 


£3 Enter your password and 


press Return. 


WORK WITH THE BOURNE-AGAIN SHELL 


or you can start the bash shell from the command 
line. The Bourne-again shell is a popular alternative to 
tcsh, which is commonly used on Linux computers. 


VY ou can use bash instead of tcsh as your primary shell, 


The original shell on early Unix systems, /bin/sh, is known 
as the Bourne shell after the programmer who wrote it, 
Steven Bourne. The bash shell takes its name from Bourne 
in a clever play on words. The Bourne-again shell is more 
compatible with the commands of the original /bin/sh 
program than the tcsh shell, which is based on the later C 
shell. 


If you are a typical user, you may not see a great difference 
between the tcsh and bash shells. You can type commands 
as you normally would, redirect output, and perform most 
tasks without problems. The first obvious difference is a 
change in your prompt, letting you know that you are now 
running the bash shell. 


WORK WITH THE BOURNE-AGAIN SHELL 


You notice the second difference if you try to change your 
shell settings. The Bourne-again shell uses different 
commands to set variables. To set a variable, for either shell 
or environment, in the bash shell, you type the following: 


variable-name=value 


No set or setenv command is necessary, just the variable 
name and value, separated by an equal sign. All variables are 
automatically shell variables unless you export them as 
environment variables. To make the value of a variable 
available as an environment variable for use by other 
programs, you can type the command export variable-name. 


Another important difference is that the bash shell does not 
run the commands in the .tcshrc file when you start a new 
shell. Instead, it executes the commands in the .bashrc file 
in your Home directory. 
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START BASH FROM TCSH 


The shell starts a new bash 


Tl Type /bin/bash and press _—Shelll. 


Return. 


SET AN ENVIRONMENT 


[ferro:~} user% /oin/bash ce) 
bash-2.@5a$ which emacs r 
/usr/bin/emacs 


.85a$ | EDITOR=/usr/bin/emacs 


bash-2 .@5a$ 
bash-2 .@5a$ 


EJ Type export, a space, and 
the variable name, and press 
Return. 


VARIABLE 


EM Type a variable name, 
then =, and the value of the 


@ The variable is designated 
variable, and press Return. 6 


as an environment variable. 


CUSTOMIZE YOUR SHELL 


WORK WITH THE Z SHELL 


perform shell tasks in the highly configurable Z shell. If 
you are new to Unix, this may be much more than you 
need. 


fl f you are an advanced user, you can write functions that 


The differences between shells are most apparent when you 
are writing shell scripts, as these scripts use the advanced 
features of the shell. The Z shell uses a number of functions 
that you can define in order to override or change default 
behavior. 


The Z shell was created to be compatible with another early 
shell known as the Korn shell, or ksh. If you are going to be 
using your shell a great deal and want to become more 
familiar with shell customization, the Z shell may be a good 
choice for you. 


Many of the built-in commands familiar from the tcsh shell 
have different command names and values in the zsh shell. 
For example, you can set zsh shell options — similar to shell 
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“aI 


[ferro% Ei 


START ZSH FROMTCSH The shell starts a new zsh 


LR Type /bin/zsh and press uss 


Return. 


variables in tcsh — by using the command setopt, and you 
can set and export environment variables as you would in 
bash. Instead of running the contents of the .tcshrc file 
when a shell starts, the zsh shell executes commands in the 
.zshrc file in your Home directory. Aliases in the zsh shell 
must be set using the following syntax, which differs from 
the tcsh shell by the requirement of an equal sign: 


alias short-alias='command and options’ 


You can take full advantage of the extensibility of the Z shell 
by creating specialized functions in your .zshrc file. A 
function creates a command, similar to an alias but with 
more flexibility and control. To learn about Z shell 
functions, you can see the manual pages for zsh by typing 
man zsh. 
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. - sa 
Ferro% 


ferro% which cp 


conmand cp ~i “$e” 


ferro% cd Pictures 

ferro®% cp wwnkd_@3@.gif wmnkd_031.gif 
overwrite wankd_@31,gif? no 

ferrox ff 


CREATE A SIMPLE 


3 | Press Return. 
Z SHELL FUNCTION 


7 The Z shell defines a new 


Type function cp(), a 


command named cp. 
space, and then type {. 


74 Type command cp -i "$@", 
a space, and then type }. 


UNIX FOR MAC 


SUSPEND THE CURRENT PROCESS 


Y: can suspend a process to regain control of the and suspend them if you have sufficient privileges. You can 


command line, and from that point, kill the process, also move processes to the background so that you can 

move it into the background, or leave it suspended issue other commands. 
until you are ready to restart it. Just as almost everything that 
makes up a Unix system is a file, almost everything that a 
Unix system does is a process. The shell that responds to the 
commands you enter in a Terminal window is a process. 
Each command you enter is a process. When you ask the 
system what processes are currently running, that too is a 
process. Just as Unix makes little distinction between system 


Every process has a process [D — a unique numeric 
identifier that the system assigns. While you enter a 
command in your shell, that shell is an active process. 
When you press Return, the command that you just 
entered starts running, and your shell is suspended until 
that process completes. 


files, application files, and personal files, it makes little You can suspend a process by pressing Control + Z. When 
distinction between system processes, applications, and the you suspend a process, it cannot run. It does not access 
commands that you enter ina Terminal window. The activity files, accumulate run time, or task the CPU. A suspended 
of the system is implemented as a series of processes. process is also referred to as a stopped job. 


Unlike some operating systems, Unix systems like Mac OS X 
allow you to gather a lot of information about the processes 
that are running on your system. In fact, you can start, stop, 


SUSPEND THE CURRENT PROCESS 


@ Terminal File Edit Scrofiback Font Window Heip oe 
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Polen as see 


EI 


BUN SEQUENTIAL COMMANDS Mi The find command starts Type date and press The system ignores the 
looking for a file named ps. Return. date command, storing it 
; in a queue, until! the find 
type the command find /usr W@ The find command pita fahes 

-name ps -print and press generates a lot of output. : 
Return. 


1 In a Terminal window, 


me % | 


WORK WITH PROCESSES 


On a multiprocessing system such as Unix, many processes appear to 
be running at the same time. They are actually running in quick 
succession, taking turns using the system's CPU and memory. The 
system tracks the resources that each process requires and restores 
the process environment as needed each time a process gets its turn 
to run. At almost any instant in time, most processes are waiting for 
some resource, whether that resource is a response from the user, 
data from the disk, or simply a turn at the processor. 


Processes change state frequently while they are running. Process 
states include running, sleeping, stopped, and terminated. 


When you suspend a process, you essentially put it on hold so that 
you can run other commands. Similar to putting a caller on hold, 
suspending a process means that no progress is made as long as that 
process is suspended. The process is stopped, awaiting your instruction 
to start again or to terminate and release all of its resources. 


You can open a second Terminal window when you are working on 
the system, but this is not an option if you are logged in remotely. 
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SUSPEND A PROCESS 


LB Type man date and press 
Return. 


date - display or set dote and time 
SYNOPSIS 
date [-nu] [-r seconds] [+format] 
ide mr j}ddjhhjmm{ .ss 
DESCRIPTION 
ES: 


way 
or set the date. Only the superuser may set the date. 


The options are as follows: 


date displays the current date and time when invoked without argumen : 


Providing arguments will format the date and time in a user-defined = 


-n The utility timed(8) is used to synchronize the clocks on gr 


1} + 491)/Suspended man date 


[ferro:~] user% 
BP) OC a 


EA Press Control + Z to Unix assigns a job number The system responds with 

suspend the process. to the suspended process and _ another prompt indicating 
displays its process ID. that you have control of 

E) Press Return. the shell. 


RESTART A PROCESS 


ou can save some work by restarting a suspended 

process. Instead of running the job again, you can 

pick up where you left off when you suspended the 
process. In addition, restarting a suspended process frees 
resources tied up by that process. 


All processes that you run, suspended or not, are associated 
with the particular shell in which they were started. If you 
suspend a single process in each of two Terminal windows, 
for example, each of these processes will have 1 as its job 
number. At the same time, each of these suspended 
processes will also have a unique process ID. Where each 
job number is related to the parent shell and only the 
parent shell, each process ID is related to the entire system. 
This means that you can refer to a process by its job 
number only in the shell in which it was started. 


Job numbers are always small numbers like 1 or 4. While 
you can accumulate a large number of suspended jobs if 
you work at it, in practice this is never done. Process IDs are 
usually large numbers like 325 or 5234. The system assigns 
these numbers in some fashion, reusing the numbers as 
needed. If you see a process running today with the process 
ID 4321, you might not see this number used again for 
months. Process numbers that are small like 1 or 69 are 
assigned to system tasks. 


To restart a suspended process, use the fg (foreground) 
command. If only one suspended process is in your current 
shell, that process restarts. If there are several suspended 
processes, the one most recently suspended will restart. To 
restart a particular suspended process, enter the fg 
command followed by its job number. 


RESTART A PROCESS 
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Suspended 

~ Suspended 

+ Suspended 
{ferro:~] user® |! 


LIST SUSPENDED PROCESSES 


#! The system displays a list 
of suspended processes with 
their job numbers enclosed in 
square brackets. 


LB Type jobs and press 
Return. 


wSH1) 


tesh ~ C shell with file nome completion and comnond line 
editing 


SYNOPSIS 
tesh [-bedefFimgstvyxx} [-Dnomefevetue])} [org ...] 
tesh «1 


DESCRIPTION 
tcsh is an enhanced but completely compatible version of 
the Berkeley UNIX C shell, csh(1). It ts a command Lan~ 
guage interpreter usabie both as an interactive login 
shell and o shell script command processor. It includes a 
command-line editor (see The command«line editor}, pro- 
grommabie word completion (see Completion and listing), 
spelling correction (see Spelling correction}, a history 


mechanism (see History substitution}, job cantrol (see 


Jobs) and a C-like syntex. The NEW FEATURES section 
describes major enhancements of tesh over csh(1). 
Throughout this manual, features of tcsh not found in most 
csh(1}) implementations (specifically, the 4.485D csh) are 


RESTART THE LAST 


@ The most recently 
SUSPENDED PROCESS 


suspended process begins 


RB Type fg and press Return. where it left off. 


WORK WITH PROCESSES 


You can only restart a process that has been suspended. You 
cannot restart a process that has run to completion or a 
process you have terminated. Each process has a life of its 
own. Even if you run the same command seven times in a row, 
each running is an independent process. 


You can restart processes by bringing them back into the 
foreground, and they will then continue running as if they had 
not been suspended. You can also restart processes by sending 
them to the background and continue entering commands 
from the shell from which these processes were run. 


If you press Control + D to exit a shell in which you have 
suspended processes, the shell alerts you to the suspended 
processes. The message "There are suspended jobs" appears. 
This warning ensures that you do not forget about commands 
that you suspended. You can still exit the shell by pressing 
Control + D again. If you exit the Terminal window by clicking 
the red button, no alert appears. The suspended processes are 
quietly killed when you close the window. 
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SS) 


[Trerro:~J user] jobs] 


RESTART A PROCESS 
WITH ITS JOB NUMBER 


ul) Type jobs and press 
Return. 
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Re Ei. 
System Generali Commands Manual 


dete ~ display or set date ond time 


SYNOPSIS 
date [{+nu] [+r seconds} [+format} 


DESCRIPTION 
dote displays the current date Gnd time when invoked without arguments. 
Providing arguments will format the date and time in a user-defined way 
or set the date. Only the superuser may set the dote. 


The options are as follows: 


nm The utility timed(8) is used to synchronize the clocks on groups - 
of machines. By defoult, if timed is running, date will set the 
time on atl of the machines im the local group. The -n option 
Stops date from setting the time for other than the current 
sochine , 


Print out the date and time that is seconds from the Epoch. 


The system displays a list Type fg %1 and press The process that was 
of suspended processes with Return. suspended first starts running 
their job numbers enclosed in again. 


square brackets. 


UNIX FOR MAC 


RUN A PROCESS IN THE BACKGROUND 


you to continue entering commands while that 

process runs. A process running in the background is 
not suspended; it continues to execute. When you run a 
command in the Terminal application, the output from the 
command appears on your screen. Until the command 
finishes, no other commands can run. This is called 
foreground processing. When the command finishes 
running, your command prompt returns. 


R unning a command as a background process allows 


Unix allows you to run commands in the foreground or in 
the background. Unlike commands in the foreground, 
commands run as background processes allow you to enter 
additional commands. Your shell continues prompting and 
you can continue entering commands. 


The simplest way to run commands in the background is to 
start them in the background. You can run a command in 
the background by adding an ampersand (&) to the end of 
the command line. For example, if you enter a find 


command, type an ampersand at the end of the line, and 
press Return, the find command continues processing and 
writes to your screen as it locates files that meet your 
search criteria. At the same time, you have control of the 
command line and can issue other commands while the 
find command continues to run. 


Like suspended processes, jobs that run in the background 
have both a job number and a process ID. Both suspended 
processes and background processes appear in the listing 
when you use the jobs command. The important 
difference between a suspended process and a background 
process is that a background process continues to run while 
a suspended process is inactive. 


Running commands as background processes allows you to 
get more work done in a single Terminal window. If you 
press Control + D to exit a shell while there are background 
processes running, the system issues a warning. 


RUN A PROCESS IN THE BACKGROUND 
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find / -name fg -print & 
ferro:~] user&% /: /.Frashes: Permission denied 


1 Type find / -name fg —print 
& and press Return. 


A message displays 
indicating that your find 
command cannot search 


The job number and some directories. 


process ID of the background 
process appears. 
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[ferro:~] user® find / -name fg ~print 
[3] 685 
{ferro:~] user® /: /.Trashes: Permission denied 


| date | 
Tue Jun 18 16:26:01 EDT 2603 


{ferro:~] users |] 


The find command 
continues running in the 
background, while you enter 
the date command and get 
your output. 


Type date and press 
Return. 


SS. ssa... j_&_x° 


WORK WITH PROCESSES 


You can place a process into the 
background by first suspending it 
with Control + Z and then using 
the bg (background) command to 
move it into the background. If you bg 
run a command, such as find / pwd 
' ‘ date 

-name findme -print, and then 
suspend it by pressing Control + Z, 
you can restart it in the background vw 
il eae ne 
%3. The command continues 
running and searching for your files /Users/user 

; : Thu May 1 11:12:13 EDT 2003 
while allowing you to enter other 
commands at the shell prompt. 


find / -name findme -print 
control+Z 
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| i2] + Suspended man jobs 
5 - Running find / -name fg -print 
{ferro:~] user® /: /,Trashes: Permission |denied 5 


Type !find and press The find command from Type jobs and press The output lists the 
Return. your command history runs Return. running and suspended 
again. processes. 


KILL A PROCESS 


ou can use the kill command to stop a running or if they are running in other Terminal windows. When you 
Y: suspended process. By halting a command that you issue the killal1 command, the system looks for 
mistyped, you can avoid wasting system resources or commands you are running. 


Ponratirig, gi pr Owens mae yeu CintareAnreMumnrtn: As a normal non-root user, you can only kill processes that 


Stopping a process that is running on a Unix system is you have started. As a root user, however, you can kill any 
called killing it. To kill a running process, you use the kil1 process on the system. Unix provides little protection from 
command followed by the process ID of the process. For making mistakes that can bring your system down. One of 
example, kill 1234 would kill the process with process the worst mistakes that root users can make on a Unix: 
ID 1234. To kill a suspended process, you use the kil1 Sales temireriatal + when they mean to enter kill 
command followed by the job number. For example, kill %1. The user's intention is to kill a suspended process. Typing 
%2 would kill the second suspended process. the command without the % kills a process known as init 
and will likely crash your system. For this reason, most 
After you kill a process, you cannot restart it. You can run the disciplined system administrators avoid using the root 
same command again, but this action starts a new process. el except when there is no other way to accomplish 
a job. 


You can kill a process by name. The variant of the kill 
command used for this purpose is called killal1l. If you 
enter killall man, you will kill all man commands, even 
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Erro.~} Usere | joo Es ferro:=] user® 
{2] + Suspended man jobs . PID TT STAT 
[ferro:~] user%[kill ¥2 ) 402 std S$ 0:08.67 ~tcsh (tcsh) 


{ferro:~] user% |] 457 p2 Se 
462 p2 § 
463 p2 5S 
494 p3 S+ 
{ferro:~] user% 
{ferro:~] user% |} 


100.27 -tcsh Ctcsh) 
:@8.91 man date 
706.01 Less -se /usr/share/man/cati/date.1 


t) 
7) 
7) 
0:00.20 -tcsh Ctcsh) 


ae ade 24 Type kill followed by a KILL A PROCESS BY PROCESS ID Type kill followed by 
= job ID number, such as %2, EI Type ps and press Return, 2 Process ID from the list 
Il Type jobs and press and press Return. displayed and press Return. 
Reium. The second suspended @ The second suspended 


process terminates. process terminates. 


WORK WITH PROCESSES 


You can use the ki11 command to send signals to running processes. The kill 
command is useful for terminating a process. Although most people talk about the 
kill command as if its sole function were to terminate processes, this is not the 
case. In fact, the kil1 command's real function is to send very short messages 
called signals to running processes to control the behavior of these processes. The 
default kil1 command — the command without an argument — sends a signal 
that asks the process to terminate. Systems people often refer to the default signal 
as a SIGTERM. Another common signal, referred to as a SIGHUP, for hang up, is 
most often used to tell a running process that it should go back and re-read its 
configuration file. Many system processes remain unaware that their configuration 
files have changed unless you send this signal to them. Another often-used signal 
is SIGKILL, a signal used to terminate a process that is not terminated with 


SIGTERM. 


[ferro:~] user$ man kill 
control+Z 


{[ferro:~] user% kill -KILL <type the process id> 


[ferro:~] user% jobs 
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[Ferro:~] userx|nan kiltatl] a ET 
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KILLALLC1) spond Cowal Chiends lene 
u0¢1) 


willall - kill processes by name 


SYNOPSIS 
kittall f-d § -vj [-h i -?] f-netp] £-t) f-m} C-s} C-u userd {-t try: 
] 


[-c procname] [~SIGHAL] [protname ...J 


DESCRIPTION 

Killatl kills processes selected by name, as opposed to the selectio 
n by 

pid as done by Ki11(1}. By default, it will send a TERM signal to a 


— cn SUEMGF ORONO CROC CORER IR LNRONrUNCY MORE gaa 


treat 


processes with a real UID identical to the caller of killall that ws 
the name procname. The super-user is allowed to kill any process. 


The options are as follows: 


KILL A PROCESS BY NAME The man page appears. 


In a new Terminal 
window, type man killall 
and press Return. 


> The process is killed. 
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[ferro:~] user% ips. 
STAT Bn; COMMAND 


Ol sh -c (cd /usr/share/man ; /usr/bin/tbl /usr/s © 
0:00.00 sh ~c (cd /usr/share/man ; /usr/bin/tbl /usr/s | 
0:00.01 less ~-se 

: ~tesh (tesh) 


killall man 
ips 


3 
@:08.28 -tcsh Ctcsh) : 
@1 sh -c (cd /usr/share/man ; /usr/bin/tbl /usr/s| > 
0@ sh -c (cd /dsr/share/man ; /usr/bin/tbl /usr/s © 
Q1 less -se : 
22 -tesh (t¢sh 


9:28.9 
B: 


02. 
ee. 
88. 
08. 
768, 


In the original Terminal =a] Type ps again and press 
window, type ps and press Return. 
Return. 


m Your man command is 
Your man command gone. 


appears in the process list. HM theman killall 


Type killall man and press command terminates. 
Return. 


103 


LIST ACTIVE PROCESSES 


ou can use the ps command to find out what 

processes are running on your system or to find the 

process ID for a job that you want to kill. To kill a 
process by its process ID, you obviously must know its 
process ID. Fortunately, Unix systems provide a command 
that displays information about running processes, including 
the process IDs. That command is ps. 


You can also use the ps command to display a list of all 
processes that are running on your system. Depending on 
the arguments that you provide, this list can include 
information about the time each process started and who 
started each process. 


The ps command by itself only displays a list of the 
commands you are running. To list system commands 

and the commands that other users are issuing, you add 
arguments to your ps command. The ps -aux command 
shows all processes running on the system and provides 
details on each one. 


LIST ACTIVE PROCESSES 


The ps -a command lists all users' processes. You will 
own some of these processes, while others start when the 
system boots. 


The ps -u command adds information such as when each 
process started, as well as the how much CPU and memory 
each process is using. 


The ps -x command adds processes that are not associated 
with a particular Terminal window, such as the processes 
started before you logged on. 


The most commonly used ps command for Mac OS X users 
is ps -aux, combining the most useful command options. 


By using the ps command followed by a vertical bar, 
commonly referred to in Unix as a pipe, you can restrict 

the output that it return to your specific interests. For 
example, ps -aux | grep init displays the init process 
and other processes that contain this string in their names. 


File Edit 


COMMAND 
-tcsh Ctcsh} 
~tcsh (tcsh)} 
man ps 
sh ~c (ed /usr/share/man ; /usr/bin/tbl /usr/s 
sh ~c (cd /usr/share/man ; /usr/bin/tbl /usr/s 
Jusr/bin/col 
less -se 
python 
:~] userx [} 


m8 In a Terminal window, 
type ps and press Return. 


The screen displays a list 
of the processes you are 
running. 


me 104 | 
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USER PID ¥CPU MEM VSZ 
user 8. .4 5912 988 std 8:85AM 
user 08 0.4 5912 976 1:09PM 
user 0.2 O.1 1452 308 1:89PM 
user 0.0 0.2 1828 468 1:09PM 
user Q. @.1 1828 368 1:09PM 
user 0.9 9.1 1308 3@8 1:09PM 

0.8 8.1 1 

@.8 0.6 1 


RSS TE STAT STARTED IME COMMAND [ 


o- 
= 
ne 
won 
#4 
oh 
oo 
ww 
os: aks 
or 


-@1 man ps 
.@1 sh ~c € 
.@1 sh -c € 
08 /usr/bi 
A’) 
A) 


1 less -s 
8 python 


user 1392 340 :O09PM 
15024 1496 


Se ee ooo sd 
SSSsess: 


. 


user 1:89PM 


{ferro:~] user’ 


Type ps-u_ and press 
Return. 


The screen displays a 
detailed list of the processes 
you are running. 


[ @ Terminal File Edit 


AES: REDE OCIY T ‘dies 
 [ferro:~] userx|ps -aux]i more] 


PID XCPU %MEM VS2 


1844 
15656 
1292 
1316 
16148 
15248 
31428 
14968 
1308 
13584 
14392 
1956 
22868 
1296 
1296 
1296 
1296 
15008 
1308 


SSSSSSSSSSSSSSSSSSSN 
Sesosc gone segosssesoseeosose goon 
SN OSOSSOWNWRRRPRPWUGBSWrHw 


In the Terminal window, 
type ps -aux and a space. 


a space. 


Scroiiback Font 


$1392 15@32 ?? Ss 8: 034M 


Type a vertical bar (|) and 


WORK WITH PROCESSES 


The columns in the output of the ps -aux command provide a lot of information 
about running processes. This information can help you understand who is using 
your system, what is running, and sometimes why the systems is running slowly. 
Each of these columns is explained in the table below. 


PS COLUMN MEANING 


USER Username of the person running the process. 


Percentage of CPU resources the process is using. 


Percentage of memory the process is using. 


Virtual size of the process in kilobytes. 
Size of process in memory. 


Te Associated control terminal, or 2? if there is no associated terminal. 


STAT Status of the process. 


STARTED Time, if started today, or date a process was started. 


TIME Accumulated run time. 


Command that is running, complete with arguments. 
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user 1453 3 : 5388 348 std §$ 10:578M 6:00.44 -tesh Ctcsh}P 
user 1657 i B. 53883 936 p2 S+ 11:22AM 6:00.13 -tesh Ctcsh) 
@ 4 std Rs : 4 


Window Help 


RSS TT STAT STARTED 


168 7? Ss 8:03AM 
784 7? Ss 8:93AM 
104 7? Ss 8:03AM 
100 ?? Ss 8:03AM 
1292 ?? Ss 8: 038M 
792 2? “Ss 8:93AM 
2768 #7? Ss §:03AM 


{ferro:~] user® | 


nl 
@ 
a 
@ 
@ 
® 
@ 
] 
] 
t) 
132 7? Ss 8:03AM = Q: 
@ 
@ 
@ 
a 
@ 
@ 
t) 
a 
td] 


376 ?? Ss 8:@3AM 46 /sbin/a 
164 ?? Ss 8: 34M 17 syslogd 
832 ?? Ss 8:03AM 32 /usr/sb 
504 ?? Ss $:03AM 77 netinfo 
5948 7? Ss 8:03AM 1.68 /System 
8@ 7? S 8:03AM 020.82 nfsiod 
8@ 7? S$ 8:03AM 1:08.81 nfsiod 
8 77 S$ 8:03AM 100.08 nfsiod 
8 7? S 8:03AM 300.88 nfsiod 
600 7? Ss §:03AM 08.07 /usr/sb 
8:03AM 4) 


kl Type more and press Type ps -aux | grep tcsh The screen displays 
Return. and press Return. information for each tesh 
process, plus the grep 
command used to select 
these processes. 


The screen displays details 
for all processes running on 
the system. 


MONITOR THE TOP PROCESSES 


ou can use the top command to find out which 

processes are using the most resources on your 

system. This knowledge is especially useful when 
your system is running slowly. Although processes appear 
to be running simultaneously, they actually take turns using 
the CPU. This sharing happens at an extremely rapid rate, 
but you can view some process details using commands 
such as ps and top. 


While the ps command allows you to view important 
statistics related to processes — such as how long they have 
been running or how much memory they are using — the 
ps output display order is somewhat random. To examine 
processes to determine how much demand they are placing 
on the system, another tool is more appropriate. That tool 
is top. 


The top command orders its output to display the tasks 
using the bulk of the CPU time available at the top of the 
list. The columns in the top output are similar to those that 


the ps command displays. In addition, the top command 
provides useful information about processes in general and 
system performance. 


The information included in the top output for each process 
includes the process ID (PID), the simple command without 
arguments, and the percentage of CPU usage. It also includes 
information on threads and memory sizes. 


Some of the information the top command displays tells 
you a lot about system performance. For example, if a 
system is more than 90 percent idle, you know that the 
system is not running more processes than it can handle 
and you can assume that performance is good. Another 
good indicator of performance is the system load. The top 
command has numerous options that you can use to alter 
its behavior. For more information on these options, type 
man top and press Return. 


MONITOR PROCESSES WITH TOP 
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2 Press Control + C. 


28 In a Terminal window, 
type top and press Return. 
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Processes: 48 total, 2 running, 46 sleeping... 104 threads 
Load Avg: @.26, 0.19, @.06 CPU usage: 2.8% user, 5.6% sys, 91.6 

SharedLibs: num = 7, resident = 2.21M code, 136K data, 568K LinkEdit 
MemRegions: num = 2683, resident = 22,5M + 6.80M private, 38.1M shared; 
PhysMem: 29.3M wired, 53.0M active, 62.8M inactive, 145M used, 111M f © 
VM: 1.016 + 3.62M 5331(@) pageins, 1(@) pageouts F 


PID COMMAND RCPU TIME 
1097 top 

1094 lLookupd 
1047 tcsh 

1046 Login 
1038 python 
1030 less 

1029 col 

1026 sh 

1025 sh 

1024 man 

1019 tcsh 

1018 Login 

4t7 Grab 
{ferro:~] user® 


#TH #PRTS #MREGS RPRYT RSHRD RSIZE 
14 228K = 328K 524K 
340K 512K = 876K 

S@8K 656K 976K 

248K 380K 865 76K 

516K 1016K 1.46M 

64K =384K 0 348K 

120K =6—304K = 388K 

S6K 712K 296K 

48K 712K 456K 

88K 324K «=. 388K 

504K 656K = 972K 

244K 380K 572K 
4.40M_8.87M_ 9.20M 


R 
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Mi The top command stops 
processing. 


The top command 


displays information about 
processes. 


WORK WITH PROCESSES 


You can use the top command to determine how hard your 
system is working. The load averages that the top command 
displays tell you how many jobs, on average, were ready to run 
but were waiting for access to the CPU. Small load averages like 
those shown in the top output support the conclusion that the 
CPU on this particular system is not busy and that processes 
rarely have to wait for access to it. Load averages above four may 
indicate a system that is burdened. Load averaging higher than 
10 indicates a system with excessive CPU contention. 


You can use the uptime command to see how many users are 
logged on and to display load averages. This command tells you 
how long the system has been up, how many users are currently 
logged on (though it counts each Terminal as a separate logon), 
and the 1-minute, 5-minute, and 15-minute load averages. 


RESULT: 


2:26 PM 4:18, 3 users, load 
averages: 0.03, 0.03, 0.01 
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erro:~] users jtop -e]] & Processes: 48 total, 2 running, 46 sleeping... 103 threads 

© Load Avg: 8.23, @.17, 8.02 CPU usage: 2.7% user, 2.1% sys, 95.3 
: Networks: 15@8 ipkts/177K 3136 opkts /2997K 
§ Disks: 145707 reads/635732K 41968 writes/172599K 
i : 5331 pageins 1 pageouts 
: KCPU TIME PAGEINS COW_FAULTS MSGS_SENT | 
; 1.9% 0:00.30 @ : 

ES i 0.0% 0:00.58 a 
: @.0% 0:00.24 () 
‘ 0.0% 0:00.81 @ 
i 0.0% @:00.08 a 
: 0.0% 8:00.01 ) 
' @.8% 0:00.00 Q 
t 0.0% 0:00.01 a 
i 0.0% 0:00.01 Q 
H 0.0% 0:00.01 @ 
i 8.0% 0:00.23 Q 
brs @.0% 6:00.81 Q 
Q 5@.0% 2:35.93 2 212080 

Type top -e and press The top command 
Return. displays processing events 


for the top processes. 


.. WRITE A SIMPLE SHELL SCRIPT 


ou can place commands that you repeatedly execute 
in a file and execute these commands by entering the 


name of the file. A file of Unix commands that you 
execute is called a shell script. Writing shell scripts can save 
you a lot of work and make it unnecessary for you to 
remember complicated commands. 


The Unix commands that you place in a script are 
commands that you might have entered in a Terminal 
window. When you run the script, the system executes the 
commands in the order entered. Shell scripting is a very 
basic form of Unix programming, although scripts can run 
the gamut from a simple list of commands to elaborate 
programs with looping, embedded functions, and complex 
data structures. 


If you enter a command such as 1s in a Terminal window, 
the shell passes the command to the kernel for execution. 
The result is a listing of your files. If you enter the same 


WRITE A SIMPLE SHELL SCRIPT 


Terminal File Edit Seroiiback Font Window Help 
ree 


To start the Pico text 
editor, type pico and press 
Return. 


command in a file and execute that file, you also get a 
listing of your files. While there is no advantage to 
executing a simple command such as 1s using a script, the 
advantage to scripting becomes readily obvious when you 
need to execute complex commands or many commands in 
a certain order. In fact, script writing is so efficient that 
nearly everyone who manages a Unix system automates 
routine tasks by writing scripts. 


You can write shell scripts that ask the person running them 
to supply some information or that make use of the user's 
shell variables. For example, one of the simplest shell scripts 
you can write greets a user when he or she executes it. If 
you place the command echo hello, $USERina file, the 
user running the script sees a personalized message such as 
"hello, jdoe." 
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Terminal — typi —_— 


hello, SUSER 


Read File 
a) Where is 


Cut Text Cur Pos . 
UnCut Tex To Spell 


fe Get Help Writedut 
a Exit Justify 


Type hello, $USER. 


The shell variable SUSER 
contains your username. 


Type echo followed by a 
space. 


AUTOMATE SHELL TASKS 


You can write scripts that are easier to understand and maintain by 
adding comments that explain the complicated commands and 
describe how the scripts work. Comments are lines in scripts that the 
system ignores when it runs the script. Comments serve the function of 
explaining your script to others who read it so that complex commands 
are easier to understand and so other users do not have to read the 
entire script to know what it is supposed to do. 


To turn a line of text in a script into a comment, insert a pound sign (#) 
in the first column. The shell ignores that line when it runs the script, 
so you can place anything you like in a comment. You can also add 
comments to the end of a line of code by adding # at the end of the 
Unix command and before the text of your comment. Always place at 
least one space or tab on each side of the #. 


While it is a good idea to include some comments in a script to explain 
what the script does, you do not need to comment every line of code. 
Inserting one or two lines of comments at the beginning of a script is 
useful. Placing a comment on every other line is distracting. When you 
run this script, the shell ignores the comments. 


TYPE THIS: RESULT: 


# this is a script that greets the user > hello, user 
echo hello, SUSER # address user by his username 


~ 
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echo hello, $USER echo hello, $USER 


) Get Help @ i 4 
@ Cancel i {ferro:~] user® || 


4 Press Control + O to write G Press Return. Press Control + X to exit 
out the file. Pico. 


Ey Type a name for your new 
shell script. 


RUN A SIMPLE SHELL SCRIPT 


remember complicated Unix commands by placing 

commands in scripts and running the scripts. When 
you run a script, you can execute a sequence of commands 
by typing no more than a single filename. After you turn a 
series of commands into a script, you can type the filename 
of that script just as if it were another Unix command. In 
fact, many Unix advocates like to think of scripts as 
extensions to the operating system. In a sense, when you 
create a script, you add a new command to your system. 


Y ou can save yourself a lot of work and better 


You can execute a script in two ways. The first way is to 
type the command source, followed by the name of the 
script. When you use the source command, the shell reads 
and executes the file one line at a time just as if you were 


RUN A SIMPLE SHELL SCRIPT 


Terminal File Edit  Scroliback Font Window Help 


t users 
Fferro:~] user [] 


ee 


@ The shell runs the 
commands in the specified 
script. 


ull Type source followed by a 
space. 


3) Type the name of a script 
and press Return. 


typing each line in the Terminal window. The second way is 
to first make the script executable and then execute it by 
typing its name. See Chapter 2 for more information on file 
permissions. 


For a script that you intend to run many times, changing the 
file permissions so that you can run it by entering only its 
name can save you time. If you use the chmod a+x 
command, other users can execute the script too. 


The source command is especially handy when you want 
to run scripts that do not have execute permissions set. If 
you do not own a script and cannot change its permissions, 
you may still be able to run it by using the source 
command. You must have read permission, which enables 
you to read a file, to run it using the source command. 
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Type chmod followed by a 
space. 


Type the name of a script 
and press Return. 


@ The chmod command 
adds execute permissions for 
all users. 


Type a+x followed by a 
space. 
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While the source command is very handy, especially for running 
scripts that do not have execute permissions set, an important 
restriction applies. The commands in the script must be 
compatible with the shell that you are using. If a script contains 

any shell-specific syntax, such as the looping commands discussed 
in the section "Write A Conditional Shell Script," you can only 
successfully execute the file using the source command when you 
run the shell that accepts that syntax. Keep in mind that this is just 
like entering the commands by hand. If you cannot use a command 
in your current shell because your shell does not accept the syntax, 
you also cannot use the source command to run a script that 
contains that command. For example, the set command assigns a 
value to a variable in tcsh. This tesh-specific command, referred to 
as a built-in, makes no sense to sh and zsh. If you are a tcsh user, 
you can source a file that contains a set command to establish the 
value of a variable; this will not work in the Bourne shell. 


Type the following lines into a file called macosx. Notice that the 
shells do not process the file in the same way. 


Example: 
set OS = "Mac OS X" 
echo I love $05 


AUTOMATE SHELL TASKS 


TYPE THIS: 
Ww 
RESULT: 


I love Mac OS X 


TYPE THIS: 


[ferro:~] users /bin/sh 
sh-2.05a$ source macosx 


Ww 


sh-2.05a$ source macosx 
I love 
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Type Is -I followed by a The screen displays the Type ./ followed by the The shell executes the 
space. script's file permissions. name of a script and press commands in the script. 
Return. 


Type the name of a script 


and press Return. 


WRITE LOOPING SHELL SCRIPTS 


ou can issue a command or a list of commands many 

times by placing a loop in your shell script. Adding a 

loop keeps you from having to run your script for 
every file in a directory or every value in a list. 


When you want your script to loop through a series of files, 
numbers, or other values, you can use a looping command. 
To ensure that the proper shell is used when your script 
runs, you can add a line to the top of your script beginning 
with #! followed immediately by the full pathname for the 
particular script. For example, a script written to run in 
tcsh starts with #! /bin/tcsh. 


For tcsh, you can use the foreach command to loop 
through a set of values. The command foreach number 
(4 5 6) runs three times, once for each of the numbers 


listed. Each time through the loop, the next number is 
assigned to the variable $number. Following the foreach 
command, you can enter whatever commands you want to 
execute for each $number. You terminate your loop by 
entering the word end ona line by itself. 


For some tasks, you want the number of times that you 
loop through a set of commands to depend on the value of 
a certain variable or some other condition. For example, if 
you want to write a script that adds two numbers, you can 
write it so that it adds the numbers until the person running 
the script stops entering numbers. In this case, you use a 
while loop. A while loop continues executing as long as 
the specified test condition is true. 


WRITE LOOPING SHELL SCRIPTS 
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fule: wore 


#!/pin/tcsh 


oreach weekday ¢ Mon Tue Wed Thu Fri 3 
| _jecho Go to work on $weekday 


end *1 
echo Today 1s date +%a }- 


ge Get Help #6 WriteOut [BN Read File Bi E a Cut Text Cur Pos 
my Exit Mm) Justify i fj) Nep ms UnCut Tex To Spell 


USING THE FOREACH COMMAND 


Ell Start the Pico editor to 
create a file named work2day. 


Ed Type echo Go to work on 
$weekday and press Return. 


=} Type end, press Return, 
and then type echo Today is 


2 bi 
| Type #!/bin/tcsh and press te aa 


Return twice. 


Type foreach weekday ( @ Your script is complete. 


Mon Tue Wed Thu Fri ) and 
press Return. 


112 
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chmod a+x work2da’ 
.fwork2day 


Go to work on Fri 
Today is Sat 


A save your script, and exit 
Pico. 


J] Type ./work2day and press 
Return. 


Type chmod a+x work2day 


The script executes. 
and press Return. 


AUTOMATE SHELL TASKS 


You can often reduce the lines in a script 
by placing repetitious commands in a 
loop. You can loop by using any of the 
shells provided with Mac OS X. The 


[ferro:~] Suser /bin/sh 


foreach and while commands are sh-2.05a$ for weekday in Mon Tue Wed Thu Fri 
built-ins associated with tcsh and csh. > do 
You must use a different syntax if you 


> echo Go to work on Sweekday 


oes . : > done 
are writing scripts in bash, zsh, or sh. 


The for command syntax for these 
shells uses the word for, followed by 

a variable name and the word in, 
followed by list of values. The words do 
and done mark the beginning and end 
of the commands to be executed in your 
loop. Make sure that you use /bin/sh, 
/bin/bash, or /bin/zsh when you 
run the following exercise that loops 
through the days of the week. 
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4. 


es : 
PIEOC & 
| Fi /bin/tesh #1 /bin/tcsh 
: set num = @; set sum = @ 


white Snum t= |" 
an set sum =|"expr $sum + Snum’ 


me Get Help WriteOut BY Read Filemy py Pg fy Cut Text Cur Pos 

By Exit 2B) Justify #B) Where is t Pg il UnCut Texglj To Spell J 
USING THE WHILE COMMAND _ SA Type while $num1 != "" Type echo —n "number> " ti] Type end and press 
WH c.a:f the Pieorediterte and press Return. and press Return. Return twice. 
create a file named addloop. =] Type set sum = ‘expr $sum Type set num = $< and EJ) Type echo $sum. 

EA Type #t/bin/tcsh and press + $num and press Return. press Return. Bisset curiletandient 
Return twice. Note: Use single back quotes Pico. 


EI Type set num = 0; set sum (backticks) in step 5. 


= 0 and press Return twice. 


WRITE A CONDITIONAL SHELL SCRIPT 


can use an if command to test conditions in shell 

scripts and proceed with different commands 
depending on the outcome of your test. This type of 
operation is called conditional logic. All Unix shells provide 
some form of conditional logic. However, like looping, the 
syntax depends on the shell. The if command is a built-in, 
so you cannot find a file if you enter the command which 
if in your Terminal window. 


C onditional statements make scripts more useful. You 


For tcsh and csh, you follow the if command with the 
condition you want to test enclosed in parentheses, 
followed by the word then. To test if a number is equal to 
0, for example, your command is if ( $number == ) 
then. To test whether a variable contains a particular string, 
enclose the string in quotes: if ( S$answer == "yes" ) 
then. 


WRITE A CONDITIONAL SHELL SCRIPT 


You then enter a list of commands that you want to execute 
if the condition you specified is true. For readability, script 
writers usually indent these lines. After this list of 
commands, end your conditional statement with the word 
endif ona line by itself. 


In bash, sh, and zsh, the if statement takes a different 
form. You follow the word if by a set of square brackets 
that enclose the test condition. Follow the brackets with a 
semicolon (; ) and the word then. You can type the word 
then on the following line if you prefer. You terminate the 
list of commands to be executed with fi. 


You can also specify a list of commands that should run if 
the specified conditions are not met. In both forms of if 
commands, you use the word else to begin this list. An 
else class must follow the if clause that it is related to. 
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USING TCSH 


<3 Type set day=date +%a° 


El Start the Pico editor to and press Return twice. 


create a file named 


Note: Use single back quotes 
work2day3. 


(backticks) in step 3. 


3) Type #!/bin/tcsh and press ZY Type if ( $day == "Sat" || 


Return twice. 


2 


Return. 


$day == "Sun" ) then and press 


Ter minal — typd 


#!/bin/tcsh 
set day=‘date +%a° 


if ( $day == “Sat“ {|} $day = “Sun” ) then 


[{___lecho Sleep in 


fetse] 
| __fecho Ge to work| 
endif 


{ferro:~] user% [j 


Type echo Sleep in and 
press Return. 


4 Type echo Go to work and 
press Return. 


Type else and press 
Return. 


:¥ Type endif. 


EJ Save your file, and exit 
Pico. 


It is often useful to collect information 
from the system by running a 
command and assigning its output to 
a variable. The work2day scripts in 
this chapter use backticks (>) for this. 
The output from the command 
enclosed in backticks is assigned to 
the variable and can then be 
displayed or tested. 


You can use backticks to run almost 
any simple Unix command. However, 
you should always take care to 
consider the output that will be 
assigned to your variable. It may be 
different than you expect. Be sure 
you use tcsh or csh when you 

loop on the command line. 


Terminal File Edit 


Scroiiback Font 
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AUTOMATE SHELL TASKS 


[ferro:~] user% foreach FILE ( ‘is -l1’ ) 
foreach -> echo S$FILE is a file 
foreach -> end 


Ww 


total is a file 
64 is a file 
~rw-r—-r— is a file 
1 is a file 

user is a file 
staff is a file 
134 is a file 
May is a file 

5 is a file 

07:21 is a file 
addloop is a file 


& Terminal 


File Edit Seroliback.. Font Window Help 


#1/bin/sh 
day="date +%a" 


if { $da *Sat” 3 11 ( $day == "Sun" J; then 
echo Sleep in 


[ferra:~] user® |} 


USING TCSH J Type echo Go to Work and 


press Return, then type fi. 


<2 Type day="date +%a’ and 
press Return. 


Type echo Sleep in and 
press Return, then type else 


El start the Pico editor to : 
and press Return again. 


create a file named 


Note: Use single back quotes 
work2day4. 


(backticks) in step 3. 


ed Type if [ $day == "Sat" ] || [ 
$day == "Sun" ]; then and 
press Return. 


Edi Save your file, and exit 
Pico. 


24 Type #!/bin/sh and press 
Return twice. 


EXTRACT INFORMATION WITH AWK 


files or from the output of other commands. It is 

particularly useful for extracting a portion of each 
line. You can then use the output from awk for further 
processing. 


Y ou can use the awk command to extract text from 


Like many other Unix commands, awk works well with the 
concept of white space — any combination of spaces and 
tabs that might exist between strings of text and numbers. If 
you want to display the first or the third word on every line 
of a text file, awk is the tool to use. If you want to display 
the last word on each line, awk can handle that as well. If 
the information that you want to display is not separated by 
white space, you can still use awk to extract it. 


You can use awk on the command line, or you can write 
scripts using nothing but awk commands. Though awk is a 


EXTRACT INFORMATION WITH AWK 


programming language, it is most popularly used within 
shell scripts or on the command line to select data from 
files or the output of other commands. 


Any command that you write for awk and awk scripts 
begins with an opening brace ({) and ends with a closing 
brace (}). The awk command processes lines of text one at 
a time and assigns each portion of a line to a variable such 
as $1, $2, and so on. The awk command language has some 
built-in variables such as NF and NR that represent the 
number of fields on each line and the record number of the 
current line. Fields are portions of text separated by white 
space or some other delimiter that you specify. 


You can write many useful scripts and commands using 
awk. Awk is a scripting language that includes conditional 
tests and looping. 


Terminal File Edit Scroliback font Window Help 


ESey es ee ee Se. 
{ferro:~] user%|awk |’ {print $1}' 


USING AWK ON THE 


K3 Type the name of a text 
COMMAND LINE 


file and press Return. 
ull Type awk followed by a 
space. 


2 


@ Awk prints the first word of 
every line of your file. 


Type {print $1}' followed 


by a space. 


@ Terminal File Edit Scrollback Font Window Help y 


space. 


space. 


ee ge 
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Leal 
lis ~t{l]awk ‘{print $5}° | 


cs 
Nag 


(ferro:~] user% 


Type Is -I followed by a (J) Type awk '{print $5}' | and 


press Return. 


Type | followed by a ] Awk prints the size of each 


file in the current directory. 


AUTOMATE SHELL TASKS 


Some features of the awk language give it a very different appearance than 
shell scripts. For example, variable names in awk do not start with a $. The 
variables $1, $2, and so on represent fields in the text being processed. If 
you use a variable name that has no value, awk ignores the command and 
continues processing. 


The command to display lines of text in awk is print, not echo. You must 
include lines of text in single quotation marks. Awk uses { and } markers to 
begin and end blocks of code. 
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if C$USERCOUNT > 10) then 
echo $USERCOUNT users logged in 
endif{} 


Get Help WriteOut 
Exit Justify 


Where is 


USING AWK IN A SCRIPT 


EJ Start the Pico editor to 
create a file named 
count_users. 


P43) Type #!/bin/tcsh and press 
Return twice. 


Read Filemm 


wRRADP 


eal 


ev Pg Cut Text Cur Pos 
ext Pg UnCut Te: To Spell 


E] Type set USERCOUNT 
= uptime | awk '{print $4}" 
and press Return twice. 


Z 1 Type if ( $USERCOUNT > 
10) then and press Return, 
then type echo $USERCOUNT 
users logged in and press 
Return again, and type endif. 


TYPE THIS: 


{ferro:~] cat work2day | awk ‘{print SNF}! 


RESULT: 
#! /bin/tcsh 


) 
Sweekday 
end 

+%a' 


| @& Terminal 


File Edit 


S|chmod a+x count_users 


{ferro:~] user% |] 


EY save your file, and exit 
Pico. 


Type chmod a+x 
count_users and press Return. 


Scroliback Font 


Window Hei 


L@ Type /count_users and 
press Return. 


@ Your script runs. 


EXTEND SCRIPTS WITH SED 


T he sed command lets you modify the input or output command. The command sed "s/a/z/g" changes every 


of a Unix command or the content'of a file without occurrence of the letter a in its input to the letter z in its 


having to use a text editor. Sed is a special editor that output. 
is unlike Pico, emacs, and vi. It can change the contents of 
files or the output of other commands on the command 
line. Think of sed as a pipe into which you pour text and 
out of which modified text flows. The shape of this pipe, 
representing a set of editing commands that you specify, 
determines what text changes and how that text changes. 


If you want to change a number of strings at the same time, 
create a file containing all of your substitutions. The 
command sed -f subs < infile > outfile looks 
for a series of change requests in the file subs, applies 
these changes while processing the file called infile, and 
writes the changed text to out file. 


The simplest sed command replaces one string with 
another string. The command echo Please go to work 
today | sed "s/go to work/stay home/" prints 
"Please stay home today”. 


If the text that you want to change includes a forward slash 
(/), you can see where sed might be confused as to what 
portion of text it needs to change. However, you can specify 
a different delimiter to separate the old and new text. The 


Sed changes one instance of the first string to the second command sed _ "s:old:new:" works as well as sed 
on each line. If you want the same text to change every "s/old/new/". Whichever delimiter you use, be sure to 


time it appears in a line, add the letter g to the end of the use three of them. 


EXTEND SCRIPTS WITH SED 


s Terminal — ttypt 
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[cat_message]i| sed “s/go to 


Please stay home today. 
Don't forget to take your Lunch. 
LU 


Please go to work today. 
Don't forget to take your Lunch. 


(ferra:~} users [) 


USING SED ON THE 
COMMAND LINE 


EI Start the Pico editor to 
create a file named message. 


3 Type Don't forget to take 
your lunch. 


Type cat message followed Type sed "s/go to work/stay 
by a space. home/" to replace one piece 
of text with the other and 
press Return. 


Ba Save your file, and exit Type | followed by a 
Pico. space. 


Z4 Type Please go to work M@ The screen displays text 


today. and press Return. that asks you to stay home 
today. 


As with awk, you can use 
sed to create fairly 
complex scripts, but you 
most often use the 
command to extend shell 
scripts. Scripts written 
entirely in sed can be 


simple or extremely 
challenging. Try a simple 
sed script like that shown 
here. Enter this script in a 
file called oneline and 
make it executable. It 
joins lines of a file into a 
single line by removing 
linefeeds. Then, try the 
following commands. 


spose 
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#!/bin/tcsh 


echo Today is Gate +%a 
T date +%a s+ "Sat™ | date +%0° == “Sun ther] |] 


H Get Help 
mM Exit 


WriteOut 8 Read Filelm 
Justify Where is 


Cut Text 
UnCut Tex 
USING SED IN A SCRIPT 


4 Start the Pico editor to 
create a file named what2do. 


+%a° and press Return. 
Ga Type if (“date +%a° == 


74 Type #!/bin/tcsh and press 


Return twice. then and press Return. 


Cur Pos 
To Spell 


3 Type echo Today is ‘date 


"Sat" || date +%a == "Sun" ) 


AUTOMATE SHELL TASKS 


#!/bin/sed -nf 
H 
$ { 


x 
s/\n//g 
Pp 

} 


cat message | sed -f changes 


IH else 
cat message 


endif 


{ferro:~] user® 


[ferro:~] user®ltcs 
Today is Sat 


Please stay home today. 


[ferro:~] user® || 


Type cat message | sed -f 
changes to replace portions of 
the message text and press 
Return, then type else and 
press Return again. 


Type cat message and 
press Return, then type endif 
and press Return again. 


Red Save your file, and exit 
Pico. 
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echo “s/go to work/stay home/” > changes 
{ferro:~] user®lecho “s/take your/moke me some/” >> changes 
. fat cdo =i 


Don't forget to make me some Lunch. 


TYPE THIS INTO A FILE NAMED ONELINE: 


[ferro:~] echo a > mytext; echo b > mytext; echo c > mytext 
{ferro:~] user% ./oneline < mytext 


ae 


J Type echo "s/go to 
work/stay home/" > changes 
and press Return, then type 
echo "s/take your/make me 
some/" >> changes and press 
Return again. 


= Type tcsh /what2do and 
press Return. 


The script tells you to stay 
home if it is a weekend day. 


ee 


SCHEDULE SCRIPTS TO 
RUN AUTOMATICALLY 


automatically at a time you specify. This can keep you 
from forgetting to run routine scripts and can allow you 
to schedule big jobs to run when the system is not busy. 


Y ou can schedule scripts or other Unix commands to run 


Use the cron command to schedule the execution of 
commands or scripts. Cron makes use of files called 
crontab files that specify what time commands and scripts 
are to be run. All crontab files have the following format: 


min hr day month day-of-week command-to-run 


The first field represents the minutes, and the second 
represents the hours. If you want a script to run at 2:15 p.m. 
every day, enter 15 14 for these fields. The entry 8 1 in the 
day and month fields means January 8", The day-of-week 
field must be a number between 0 and 6; Sunday is 0, 
Monday is 1, and so on. 


SCHEDULE SCRIPTS TO RUN AUTOMATICALLY 
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& Terminal 


#1 /binétcsh 
set when = date +%H:%M 


set diskspace = ‘/usr/bin/du -sk ~$USER- 
echo $when $diskspace >> ~$USER/duiog 


{ferro:~] user% [! 


1] Start the Pico editor to 
create a file named 
check_space. 


ma Type set diskspace = 
*/ust/bin/du -sk ~$USER’ and 
press Return, then type echo 
$when $diskspace >> 
~$USER/dulog. 


74 Type #!/bin/tcsh and press 
Return twice. 


J Save your file, and exit 
Fico. 


Type set when = ‘date 
+%H:%M* and press Return. 


120 


Time fields can include a string of comma-separated values 
or an asterisk (*). An asterisk indicates that every possible 
value for the field is valid. In the day-of-week field, for 
example, * tells cron to run the command every day of the 
week. Typing 0,30 in the minutes field tells cron to run the 
command on the hour and half hour. You can also specify 
values such as */10 in the minutes field to tell cron to run 
the command every ten minutes. 


A job scheduled to run via cron only runs if all of the 
timing criteria are met. For example, the line 5 17 * * 5 
/Users/user/bin/send_week]ly runs the 
send_week1y script every Friday at 5:05 p.m. 


To schedule jobs to run automatically, use the crontab -e 
command and add a line for each command or script you 
want to schedule. 
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Type crontab -e and press 
Return. 


Cron stores files in /var/cron/tabs, 
and each file is named after the user 
who owns it. The cron process starts 
when the system starts up and is one 
of the processes that runs all of the 
time. Such processes are referred to as 
daemons. The format of crontab 
entries is fairly rigid. 


If you do not include the required five 
timing fields, the system does not set 
up your cron jobs and asks when you 
try to save the changes if you want to 
retry your edits. If you do not retry 
your changes, cron leaves your 
crontab file unchanged. You should 
never edit cron files except through 
the crontab -e command, and the 
system protects against this by setting 
the permissions of the cron files so 
that you can only edit them as root 
and, of course, the crontab process. 
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es * * * * /Users/user/check_space > /dev/null] 
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Type */5 ee KK 
/Users/user/check_space > 
/dev/null, replacing user 
with your username. 


E} save your cron file, and 
exit the editor. 


AUTOMATE SHELL TASKS 


TYPE THIS IN YOUR CRONTAB FILE: 


*/5 * * * 7 /bin/echo hello > /dev/ttyp1l 


WwW 


RESULT: . 


Cron does not let you save the file. The 7 in the day-of-week 
field is invalid. Only a value between 0 (Sunday) and 6 
(Saturday) is allowed in this field. Change it to the proper 
digit for the current day of the week and "hello" messages 
should appear in your Terminal window after a few minutes. 
To inactivate the line without removing it, use the crontab 
~e command again and type a pound sign (#) in column 1. 
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oo 


erro:~] user&ichitod a+x check_space 
ferro:~] user’ |crontab ~-1 


*/5 * * * /Users/user/check_space >> /Users/user/dulog 
L 


Type chmod a+x ul) Type crontab -I and press 
check_space and press Return. 
Return. 


Your scheduled job 
appears. 


OPEN AQUA APPLICATIONS 
FROM THE SHELL 


Y ou can use the shell command open to open a file from the period (.) on. For example, the filename my-dog.jpg 


in an Aqua application such as TextEdit, Preview, has an extension of .jpg. Mac OS X uses the default 

Photoshop, or Microsoft Word. The file opens as if application for opening JPG files. This is the same method 
you had double-clicked it in the Mac OS X Finder. There the Mac OS X Finder uses to determine which application to 
are three ways to use the open command: use when you double-click the icon of a document. 


Not all Unix text files end with the .txt extension. An HTML 
file may be named about-cat.html. If you use open, the file 
opens in a Web browser, but if you want to edit it, you may 
want to use TextEdit. The second form of the open 


open filename 
open -e filename 
open -a Application-name filename 


The first version of this command launches an Aqua command, with the -e option, opens the file in TextEdit, 
application to open the designated filename. Mac OS X which lets you edit text files not ending in the .txt 
associates each document with information known as extension, such as HTML pages or configuration files. 


metadata. This metadata includes information such as 
which Aqua application created the file. The open 
command launches that application. 


The third version of the command lets you specify which 
application to use. You can name any application located in 
the /Applications directory or its subdirectories. You can 

If the application that created the file is not listed in the start the application with a blank file by omitting the 
metadata, then Mac OS X looks at the extension of the file. filename argument. 

The extension is the last part of the filename that appears 


OPEN AQUA APPLICATIONS FROM THE SHELL 
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{ferro:~] user® 1s [ferro:~} user% is iC) 
Desktop Library Music Public cat-pic. jpg = Desktop Library Music Public cat-pic, jpg : 
Documents Movies Pictures Sites Documents Movies Pictures Sites i 
: %| open] cat-pic. jpg} {ferro:~] user® open cat~-pic. jpg | 
{ferro:-] user® [ferro:~] users [] 


OPEN AN IMAGE FILE 4 Type the name of an Aqua starts the appropriate 
image file and press Return. viewer program and displays 


i Type open and a space. sieaueee 


The open command is not limited to only 
opening files. If you provide other arguments, 
the open command tries to display those 
arguments in the appropriate viewer or editor. 


One of the most useful ways to employ open is 
to open directories in the Mac OS X Finder. This 
command creates a Finder folder window to 
open the current directory. 


[ferro:~/Pictures] user% open 
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| MR ae 
(ferro: /use/share/calendar] user® is Bi 

calendar.birthday calendar.computer calendar.holiday calendar.music i 

calendar.christian calendar.histor calendar. judaic calendar. usholiday 


erro: /usr/share/catendar] userk|open|-e|calendar computer 


OPEN ATEXT FILE IN TEXTEDIT 4 Type -eanda space. 


LI) Type open and a space. 
file and press Return. 


TextEdit File Edit Format Window Help 


COMBINE UNIX AND AQUA 


The open command can also open Web URLs in 
the default Web browser you have specified in your 
System Preferences on the Internet panel. To open, 
type your URL as the argument. 


[ferro:~] user% open http://cssin24hours.com/ 


You may need to enclose the Web URL in 
quotation marks to prevent the shell from 
interpreting question marks and other special 
characters. 


You can also send e-mail to an address by using a 
mailto: URL. This command starts your default 
mail program and sends mail to the specified 
address. 


{ferro:~] user% open mailto:kynn@idylimtn.com 
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(ferro: /usr/share/catendar] user% 1s 

calendar.birthday calendar.computer calendar.holiday calendar.music 
calendar .christian calendar.history calendar. judaic 
(ferro: /usr/share/catendar] user® open ~e calendar. computer 


calendar .ushol iday 


_. talendar.computer 
The Epoch (Time @ for UNIX systems, Midnight GMT, 1978) a 
ARPANET converts fram NCP to TCP/IP ~ the Internet is Fe 
1983 
AT&T officially divests its local Bell companies, 1984 
Apple Computer incorporated, 1977 
American Telephone and Telegraph Loses antitrust case, 


Herman Hollerith patents first data processing computer, 


Justice Dept. drops IBM suit, 1982 

First CDC 1604 delivered to Navy, 1960 

Set uid bit patent issued, to Dennis Ritchie, 1979 
i Justice Dept. begins IBM anti-trust suit, 1969 (drops 

it, @1/08/1982) 

41/22 Apple airs “1984” commercial during Superbowl XVIII, 
4 1984 i 
9791/24 Data General Nova introduced, 1969 - 
701/25 First U.S. meeting of ALGOL definition committee, 1958 Y 
491/26 EDVAC demonstrated, 1952 b 


The TextEdit application 


SF pciticmemeoracs ri da and opens the text 


CAPTURE A SCREENSHOT FROM UNIX 


ou can create a screenshot of your current desktop and 

application windows by using the screencapture 

command. A screenshot is simply a graphics file that 
shows the state of your display at any given time. You can use 
a screenshot for troubleshooting or sharing what you see 
with someone else who does not have direct access to your 
computer. Screenshots are also useful for step-by-step 
instructions, such as those used extensively in this book. 


You can create a screenshot at any time in Mac OS X by 
holding down the Shift + Command (8) keys while typing 
the number 3. This key sequence captures whatever is 
currently on the entire screen and saves it to a file in your 
Desktop directory. The file is named Picture 1.pdf and is in 
the Portable Document Format (PDF) developed by Adobe. 
The Mac OS X Preview application or the Adobe Acrobat 
Reader program can read PDF files. If you create more 
screenshots in this manner, they receive successive 
filenames, such as Picture 2.pdf and Picture 3.pdf. 


CAPTURE A SCREENSHOT FROM UNIX 


The screencapture shell command gives you more 
control over your screenshots, allowing you to save them 
wherever you wish and with any filename. The syntax for 
this command is 


screencapture options filename.pdf 


If you use the -m option, the screenshot captures the entire 
main screen. The -i option puts the screencapture 
command into Interactive mode. In Interactive mode, you 
can define an area of the screen to capture by dragging the 
mouse. Typing a space in Interactive mode switches the 
selection from mouse selection to window selection; if you 
click a window in Window Selection mode, that entire 
window is captured. 
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-J) Type a filename ending in 
.pdf and press Return. 


Li) Type screencapture and a 
space. 


Your screenshot is saved in 
the PDF file. 


74 Type -m and a space. 


124 


CAPTURE A SECTION 
OF THE SCREEN 
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{ferro:~] user® 1s -la 

total 56 

drwxr-xr-x 13 user staff 442 Dec 24 17:22 . 
drwxrwxr-t 18 root wheel 348 Dec 23 14:34 .. 


“Pwer-ar~» user staff 3 Dec 22 21:53 .CFUserTextEncoding 
drwx--~-~= 2 user staff 68 Dec 24 17:06 .Trosh 

Pw a os ~= 8 user staff 272 Dec 24 17:22 Desktop 

drwx---~--~ 3 user stoff 102 Dec 22 21:53 Documents 


Grwx~~~--~ 19 user staff 646 Dec 24 17:10 Library 

Z user staff 102 Dec 22 21:53 Movies 

3 user staff 102 Dec 22 21:53 Music 

3 user staff 102 Dec 22 21:53 Pictures 

4 user staff 136 Dec 22 21:53 Public 
staff 176 21:53 Sites 

staff 24301 17:13 cat-pic.jpo 


drwxr-xr-x 
drwxr~xr-x 
~TWe-t--f-- 


4 Type a filename ending in 
.pdf and press Return. 


La Type screencapture -i and 
a space. 


@ The cursor becomes a 
crosshair pointer. 


COMBINE UNIX AND AQUA 


After you have captured a screenshot, you will probably want to edit it. The 
Mac OS X screen capture only saves files in Adobe’s PDF format, which is 
usually not the best format for images. Many graphics applications do not 
open PDF files, and you cannot use a PDF file as an image in a Web page or 
word processing document. 


There are two ways to deal with this inconvenient file format. The first is to 
use the Preview application, a standard Mac OS X application, to convert 
the screenshot to a different format. You can open the screenshot in Preview 
using the open command. 


open -a Preview screenshot.pdf 
The Export function is available through the File menu and allows you to 
choose a different format, such as TIFF, JPG, or BMP. 


The other approach saves your screenshot directly to the Aqua paste buffer, 
using the -c option with the screencapture command. 


screencapture -c -i 


No filename is necessary because the captured portion of the screen is 
stored in your clipboard. You can paste it into a graphics application such as 
Photoshop or Preview and then save the file in whatever format you prefer. 
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(ferra:~] user® 1s ~la 
total 56 
drwxr-xr-x 13 user staff 442 Dec pa 
drwxrwxr-t 18 root wheel 340 Dec a a 
~Pwet~-p-~ louser staff 3 Dec P2 21:53 .CFUserTextEncoding 
staff 68 Dec p or mee : 
staff 272 Dec P& 
staff 102 Dec Pe wes 21:53 .CFUserTextEncoding 
staff 646 Dec B4 17:18 Library. ; 17:06 .Trash 
staff 102 Dec 17:22 Desktop 


staff 102 Dec P 21:53 Dacument 
staff 102 Dec E 17:18 Biliary : 


drwxr-xr-x 4 user staff 136 Dec P2°21:53 Public 9 shi : 21:53 Movi 
drwar-xr-x 5S user staff 17@ Dec B2. i aah ae pool 
-rw-r--r--  luser staff 24301 Dec R417: t snag ne es 21:53 Pictures 
Cferro:~] user® screencopture -i ‘timebs otopdt : a 21:53 Public 
t 21:53 Sites 
17:13 cat-pic. jeg 


ra 


aN 


* 


Sites 
(ferro:~] user® open time-screenshot .pdf 
(ferro:~] useré if 


Position the cursor over =3 Drag the mouse to Your screenshot is saved in 
the corner that you want to indicate the section you the PDF file. 
capture. want to capture. 


4 Click and hold the mouse G Release the mouse button. 
button. 


ACCESS THE AQUA CLIPBOARD 


the pbcopy and pbpaste commands. Mac OS X 

keeps temporary data in a special memory space 
known as the clipboard or paste buffer. When you use the 
Copy function of an Aqua application, whatever you copy 
replaces the contents of the clipboard. When you use the 
Paste function, you paste the contents of the clipboard into 
the document. The Copy and Paste functions are usually 
listed in an application’s Edit menu, or you can use the 
shortcuts 8 + C for copy and 38 + V for paste. 


Y ou can copy and paste using the Aqua clipboard with 


The pbcopy command reads text from the standard input 
and places it into the Aqua clipboard buffer. You can use 
this command to read a file’s content into the clipboard by 
using input redirection from a file or by piping the output 
from another command to the pbcopy command. 


pbcopy < filename 
shell-command | pbcopy 


This action stores the contents of the file or the output of 
the command in the paste buffer, and you can paste it into 
other applications, such as TextEdit or Mail. 


If you have copied text from another application, you can 
access the paste buffer’s contents by using the pbpaste 
command. This command sends the contents of the 
clipboard to standard output, where you can redirect it 
to a file or pipe it to another command. 


pbpaste > filename 
pbpaste | shell-command 


Typing pbpaste alone displays the current contents of the 
paste buffer. If you have forgotten what is on your 
clipboard, this is an easy way to check. 


ACCESS THE AQUA CLIPBOARD 
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COPY ATEXT FILE 


3 Type a text file's filename 
TO THE CLIPBOARD 


and press return. 


LE Type pbcopy anda space. i The clipboard now 


contains the file that you can 


Z4 Type < and a space. : 
paste into other programs. 


ferro:~] user®|[pi beopy] [<]/usr/share/calendar/calendar .usholiday | r/ealendar.usholiday} ##§# 8 
{ferro:~] userk ” 


& Terminal 
808... 


fereg ee oe comubeassssem 
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drwxr-xr~x 14 user staff 
drwxrwxr~t 18 root wheel 


476 Dec 24 17:23 . 
342 Dec 23 14:34 .. 


~PWete~t~= user staff 3 Dec 22 21:53 .CFUserTextEncoding 
Orwx-~-- =~ 2 user staff 6B Dec 24 17:06 .Trash 
OW =o mw 12 user staff 4@8 Dec 24 17:29 Desktop 
ODPWx~ + e~~ 3 user stoff 1@2 Dec 22 21:53 Documents 
OIWXwe wm 19 user staff 646 Dec 24 17:10 Library 
drwx-+-~-~ 3 user staff 1@2 Dec 22 21:53 Movies 
OPW + own 3 user staff 1@2 Dec 22 21:53 Music 
Orwx~~ = «~~ 3 user staff 102 Dec 22 21:53 Pictures 
drwxr-xr-x 4 user staff 136 Dec 22 21:53 Public 
drwxr-xr-x 5 user staff 178 Dec 22 21:53 Sites 
-rw-t--r-- Luser staff 24301 Dec 24 17:13 cat-pic.jpg 


opwere-pe- 1 user staff 


269469 Dec 24 17;23 time-screenshot. pdf 


COPY COMMAND OUTPUT 


3B b 
TO THE CLIPBOARD parry eI 


Return. 


LB Type a command that 


@ The clipboard now 
outputs text and a space. 


contains the command 
output that you can paste 


74 Type a vertical pipe 
into other programs. 


character (|) and a space. 


COMBINE UNIX AND AQUA 


You can combine the pbpaste and pbcopy You can use the following command to sort the 
commands by piping the commands together. contents and then store the text in your clipboard: 
This action allows you to insert a shell command 
to modify the contents of your paste buffer. For 
example, you could copy the following text from If you paste the text into your word processor, the 
a Web site using your browser’s Copy function: list of pets is sorted: 


{ferro:~] user% pbpaste | sort -bfi | pbcopy 


Nying, a dog Angie, a dog 
Olorin, a cat Kim, a dog 

Kim, a dog Nying, a dog 
Angie, a dog Olorin, a cat 


You can extract a list of the dogs only with the 
following pipe through the grep command: 


{ferro:~] user’ pbpaste {| grep ‘dog’ | pbcopy 
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[ferro:~] users [pbpa 
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total 2112 
dewxr-xr-x 14 user staff 476 Dec 24 17:23 . 

drwxrwxr-t 18 root wheel 340 Dec 23 14:34 ., 

“Mwere=pe~ Luser staff 3 Dec 22 21:53 .CFUserTextEncoding 
drwx-~---- 2 user staff 68 Dec 24 17:06 .Trash 


drwxr-xr-x 24:17:23 . 
drwxrwxr-t 23 14:34 ., 
orW-P--r-- 22 22:53 .CFUserTextEncoding 


wneaesstonanssniitsbite indih tendsbaish esenetstsalattiaa ith’. 
on! PREOOMNE, Deora ngs 


24 17:06 .Trash drwx~ =~ 0 12 user staff 408 Dec 24 17;29 Desktop 
24 17:29 Desktop dirwx-~=--~- Zuser staff 102 Dec 22 21:53 Documents 
22 21:53 Documents OrWK =~ = ~~~ 19 user stoff 646 Dec 24 17:18 Library 
24 17:18 Library dewx------ 3 user staff 102 Dec 22 21:53 Movies 
22 21:53 Movies drwx~ ~~ ~~~ 3 user staff 102 Dec 22 21:53 Music 

22 21:53 Music drwx-=<---- 3 user staff 102 Dec 22 21:53 Pictures 
22 21:53 Pictures drwxr~xp ~x staff 136 Dec 22 21:53 Public 


22 21:53 Public 

22 21:53 Sites 

24 17:13 cat-pic. jpg 
staff 24 17:23 time-screenshot. 


staff 170 Dec 22 21:53 Sites 
Wf 24301 Dec 24 17:13 cat-pic.jpg 
17:23 time-screenshot. pdf 


drwxr=xr =x 
Ta eed oe 
PA f+oP~= 


PASTE THE CLIPBOARD 


PASTE THE CLIPBOARD 3 Type a filename and press 
TO STANDARD OUTPUT 


3 Type a command that 
INTO A TEXT FILE Return. 


reads standard input. 


1 Type pbpaste and a space. LE Type pbpaste and a space. 


The contents of the 
P43 Type a vertical pipe clipboard are sent to the 
character (|) and a space. command. 


The file now contains the 
PA Type > and a space. contents of the clipboard. 


UNIX FOR MAC 


COPY APPLE RESOURCE FORKS 


ou can copy a file and its resource fork using the 

ditto command. Mac OS X uses resource forks to 

store additional information about the file. A resource 
fork is a hidden file that accompanies another document. 
When you use Aqua applications, resource forks are created 
automatically but are kept invisible to both the Mac OS X 
Finder and the Unix shell. To list resource forks in your 
current directory, type this command: 


[ferro:~] user% is -1 */rsre 


You see that your files are shadowed by smaller files of the 
same name with /rsrc appended. Each of these files contains 
encoded information about which application created the 
file and other types of metadata. Aqua applications use this 
information, but Unix shell commands ignore it. 


The Unix cp command does not normally copy resource 
fork files because they are effectively invisible to most shell 
commands. If you copy a file or directory with cp, your 
copy does not have a resource fork. However, resource fork 
sizes are included in the disk usage totals provided by the 
du command; thus, your copy may not appear to be the 
same size as the original. 


The ditto command is another way to copy files and 
directories. Unlike the cp command, ditto copies a 
directory and its contents automatically so you do not need 
to include an -r option as you would with cp. You do need 
to include the -rsrcFork option: 


[ferro:~] user% ditto -rsrcFork original copy 


This action produces a copy with the resource forks 
preserved. 


COPY APPLE RESOURCE FORKS 
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i] user® ls «1 my~cat. jpg 
-rw-r<~p-~ douser wheel 21742 Dec 24 17:32 my-cat.jpg 
(ferro:~] user% ls ~l my-cat.jeg/rsre 

sTwet--r-~ Ll user wheel 1293@6 Dec 24 17:32 my~-cat.jpg/rsrc 


{ferro:~] user% I 


COPY A FILE 4 Type -rsrcFork and a 


space. 


Ka Type the name of a file 
and a space. 


Type ditto and a space. 


'[ferro: 
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~] user% ls ~-1 my-cat. jpg 
~re-p--r-- louser wheel 21742 Dec 24 17:32 my-cat. jpg 
[ferro:~] userk 1s -1 my-cat.jpg/rsrc 

“re-T--r-- J user wheel 129106 Dec 24 17:32 my-cat.jpg/rsrc 


erra:~) user® ditto -rsrcrork my-cat.jpg 
ferro:~} user% 1s -1 our-cat.ipg 
1 user 


PWS Po 0 Pw 


| The ditto command 
copies the file and its 
resource fork. 


Type the name of the 
destination file and press 
Return. 


— see 


COMBINE UNIX AND AQUA 


Two other commands work with resource forks to ensure that the Mac OS X Finder has 
access to metadata. These commands are the CpMac and MyMac commands. CpMac is a 
version of cp that copies files along with resource forks, and MvMac is a version of mv 
that moves files while preserving resource forks. 


The CpMac and MvMac commands are not automatically installed on all Mac OS X 
computers, but are on the Mac OS X Developer Tools CD-ROM. For more information 
on installing the Developer Tools, see Chapter 12. 


The executable files for the CpMac and MvMac commands are stored in the 
/Developer/Tools directory. If you have not added that directory to your shell’s 
path, you will have to type the full pathname to use these commands. 


Example: 

{[ferro:~] user% du -s cat~pics/ 

48744 cat-pics/ 

[ferro:~] user% cp -r cat-pics/ cat-pics~cp 

[ferro:~] user% du -s cat-pics-cp 

37872 cat-pics-cp 

[ferro:~] user% /developer/Tools/CpMac -r cat-pics/ cat-pics-CpMac 
[ferro:~] user% du -s cat-pics-CpMac 

48744 cat-pics-CpMac/ 
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(ferro:~] user% 1s = 
Desktop Library Music Public bs Desktop Library Music Public 
Documents Movies Pictures Sites j Documents Movies Pictures Sites 
ferro: ~ iditto -rsrcFork|Picturesff| ; 3 -rsrcrork Pictures| Pictures-archive| 

[ferra:~] user® ls ~1 
“Pw-re-r-- Luser staff @ Dec 24 17:83 Pictures-archive/cat-pic.jpg/rsr: 
€ 
-rw-f--r-- luser staff 129106 Dec 24 17:B2 Pictures-archive/my-cat. jpa/rsrc > 
“raere-ree Jouser staff 129106 Dec 24 17:82 Pictures-archive/our-cat.jpg/rsr- 
c : 
orware«re~ louser staff @ Dec 24 17:P3 Pictures~archive/time~screenshot ° 
.pdf/rsrc : 
[ferro:~] users § 
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COPY ADIRECTORY____§#s§=-= § £23 Type the name of a Type the name of the The ditto command 
fl Type ditto -rsrcFork and a directory and a space. destination directory and creates a copy of the 

cage press Return. directory and copies the 
we resource forks as well. 


M THE SHELL 


ou can run Applescript commands or files from the 
Y command line, letting you access and control other 

Mac OS X applications. Applescript is a simple but 
powerful programming language built into the Mac OS X. 
It is relatively easy to read and understand because it uses 
a syntax similar to English. For example, to have the Finder 
application create a pop-up dialog box, you can use the 
following Applescript: 
tell Application “Finder” to display dialog 
“Good morning!” 


The Applescript language follows the Open Scripting 
Architecture (OSA) standard, making it an OSA language. 
For a full list of OSA languages installed on your computer, 
you can type the osalang command. To execute scripts 
written in OSA languages from the command line, use the 
osascript command. There are two forms of this 
command: 


osascript script-file 
osascript -e 'one line of script’ 


tS tS a test”’ 


j This is a test 


€ Cancel’) ; 


RUN A SINGLE LINE 


fj li f Appl ipt 
OF APPLESCRIPT ype a line ot Applescrip 


within single quotation 
marks, and press Return. 


Ll Type osascript and a 
space. 


I The osascript 
command executes the 


Type -e and a space. oe 
Applescript line. 


|6h#B 


MAKE YOUR UNIX SHELL TALK 


Application to say, a space, 


The first version runs a file containing an OSA script 
language; you do not need to set the script-file 
executable. If you omit the script-file argument, the 
osascript command reads lines of script from the 
standard input. 


The second version of the command reads and executes a 
single line of script that is specified on the command line. 
You can include multiple -e arguments if you want to 
execute more than one line of script at the same time. 


The default scripting language for osascript is Applescript. 
If you have another OSA language installed, you can specify 
it by giving a -1 option to osascript, followed by the 
name of the language. 


You can use the Applescript language in many more ways 
than shown here. You can use Applescript to control most 
Mac OS X applications. To learn more about the Applescript 
language, www.apple.com/applescript for Apple’s Web site. 


losascript -e ‘tell current Application to say “IE am an| & 
App be: Conmpucen’s J rum ih Mea OS tetera i. 


Kd Type a phrase, a double 
quotation mark, and a single 
quotation mark, and press 
Return. 


4 Type osascript -e, a space, 
and a single quotation mark. 


£4 Type tell current 


M The osascript 
command tells the current 
application to speak the text. 


and a double quotation mark. 


COMBINE UNIX AND AQUA 


You can use osascript to announce the new directory each time you 
use the cd command. It uses the special tcsh shell script cwdcmd, a 
command executed each time you change the current working directory. 


Ei Create a directory for storing scripts, such as ~/Library/OSAscript. 


Create a shell script in the directory named say-dir.sh, containing the 
following: osascript -e 'tell current Application to say 
"New Dir: 'Scwd'"' 


EJ Add an alias command to your .tcshrc file that sets the cwdcmd alias: 
alias cwdcemd 'source ~/Library/OSAscript/say-dir.sh' 


™@ You can type source .tcshre to run your .tcshrc file and add this alias, or 
you can type the alias command (in step 3) to set the alias for your 
current Terminal window. 


When you change to a new directory, the cwdcmd alias executes. The 
source command reads in the shell script and runs it, calling the 
osascript command. The value of the current working directory is 
stored in the shell variable $cwd, and the new directory is announced 
because the value is used in the Applescript say command. 


There is one hitch to using this script: You will change directories slowly 
because the cd command will not end until the full path is spoken. 
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tell application “iTunes” : 'Cferro:~] user% 1s 
set this_name to the name of current track 3 Desktop Music Sites 
set this_artist to the artist of current track : Pictures current~song. script 


set this_album to the album of current track : Library archive 
set this_song to “Current Track: * & this.name & ” by " & this_artist & Movies Public 
“C" & this_album & ")" : ferro:~] useré 


IRS or ir coat toaGr Us (age cay my eat coat cme fe! LIM le | 


current~song. script: new file: 6 lines, 278 characters. 


AUN AN APPLESCRIPT FILE __ Type osascript and a The osascript 
iB Create a text file space. command executes the 


containing your Applescript, Type the name of the Applescript file. 


using a text editor. script file and press Return. 


UNIX FOR MAC 


CREATE CLICKABLE SHELL SCRIPTS 


ou can make shell scripts that you can run by double- 

clicking their icons in the Mac OS X Finder. A script is 

clickable if the name of the script file ends with the 
suffix .command. 


Ordinary shell scripts are not clickable. Double-clicking a 
shell script’s icon opens it in a text editor instead of running 
it. To make it clickable, you can make the script executable 
by using the chmod command and giving it a name ending 
in .command. 


When you double-click the icon of a .command file, the 
Terminal program opens a new window and executes the 
command in that window. For example, if you want to run 
the top program in a shell window, you can write a shell 
script like this: 


CREATE CLICKABLE SHELL SCRIPTS 


#!/bin/csh 

# top.command: 

# This script will start the top command 
with the options 

# you prefer. It can be run by double- 
clicking the file 

# icon in the Finder. 


top -u -s5 # sort by CPU, update every 5 


seconds 


If you save this file as top.command and set it as executable, 
you can double-click the icon to start the top command. You 
can also add a new icon using the Mac OS X Finder. You can 
make other types of executable programs clickable by 
renaming them to .command filenames as well. 


Terminal File Edit Scroilback font Window Help @& i) Fri 12:00 PM 


i?) eee 

ferre:~/Desktop] user’ cd 
{ferro:~} user% cat > du.command 
#1/bin/sh 


po NIRA Et 


du ~s ~/* 
[ferro:~] user% 


{ferro:~] user® G 


74 Type chmod a+x, a space, 
and then the filename, and 
press Return. 


a) Create a shell script and 
give it a name ending in 
.command. 


“9 


Sa 


a 3 Locate the file in the 
Mac OS X Finder and 
double-click it. 
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Last login: Tue Dec 24 17:08:59 on ttypi 

/Users/user/du.compand; exit 

Welcome to Darwin! 

[ferro:~] user® /Users/user/du.command; exit 
/Users/user/Desktop 
/Users/user/Documents 
/Users/user/Library 
/Users/user /Movies 
/Users/user (Music 
/Users/user/Pictures 
/Users/user/Pictures-archive 
/Users/user/Public 
/Users/user/Sites 
/Users/user/current-—song.script 
/Users/user/du.command 


Desktop 


{Process completed] 


@ The Terminal program 
opens and executes the shell 
script. 


COMBINE UNIX AND AQUA 


DRAG PATHNAMES TO THE 


TERMINAL WINDOW 


dragging the icon onto the Terminal window. The 

pathname of the file appears in the shell as if you had 
typed it. This capability is useful if you are deep within 
folders in the Finder and you want to use a shell command 
on a file you have found. You can save typing in this way 
and make it much less likely that you will mistype a 
pathname. For example, to get a long directory listing of a 
file, type a partial command and a space: 


Y ou can use any file found in the Mac OS X Finder by 


{ferro:~} user% is -1 


Then switch to Finder and locate the file. Click and hold the 
mouse button on the file’s icon and then drag it to whatever 
part of your Terminal window is visible. You do not need to 
be able to see the full window, only a portion of it. When you 


release the mouse button, the file is not moved, as it usually 
would be if you dragged the icon to a new folder. Instead, 
the file’s full pathname is pasted onto your Terminal window: 


{ferro:~] user% is -l 
/Users/user/Pictures/kitty/olorinl. jpg 


You can then press the Return key and execute the command. 
This action works with any file, including folders, to paste the 
directory path of a dragged folder into the Terminal window. 


You can drag multiple files to the Terminal if you are typing 
a command that takes several arguments, such as the diff 
shell command. You need to remember to type spaces 
between each file, or the pathnames will not be separated 
and will be read as one long pathname. 


DRAG PATHNAMES TO THE TERMINAL WINDOW 
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Terminal — tesh 


me 1 | Type a command that 
takes a filename argument. 


@ Finder File Edit View Go Window Help @& 4) Fri 12:00 PM 
/ealendar/calendar hist Fle 

ory S252 

' eintas Psyche 


486 3920 


my : 
[ferra:~/Desktop} userx {] s ie 


25101 /usr/share/calendar/caLendar . histor 


Picture i 


i Computer Home Favorites | Ap 


___L of & ems selected, 13.59 CB available 


calendar.birt ay catendar.christian  calendar.computer 


eal a 
calendar.holiday calendar judaic 


the Mac OS X Finder. 


The full path to the file is 
3 Click and drag the icon inserted at the cursor. 


onto the Terminal window. 


CONNECT TO THE INTERNET 


networks that spans the globe. This supernetwork 

makes it possible for people in New Jersey to send 
e-mail to people in Ethiopia, for teens in California to read 
their Pennsylvania grandmother's recipes on the Web, and 
for people to chat and form meaningful relationships with 
people they may never meet face to face. 


rf, he Internet is a loose connection of systems and 


Connecting a Mac OS X system to the Internet is relatively 
easy. You can establish dial-up, digital subscriber line (DSL), 
and local area network (LAN) connections, depending on 
your resources and circumstances. 


Unix systems were built to be networked. In fact, the first 
Unix systems and the first efforts to connect systems from 
different locations on the first internetworks started as 
contemporaries. Mac OS X is no exception. Mac OS X 
systems run the Internet networking protocols — a 
collection of protocols called Transmission Control 
Protocol/Internet Protocol (TCP/IP) — natively. 


(RE Finder File Edit View Go Window Help 
About This Mac 
Get Mac OS X Software... 
System Preferences... 
Dock 
Location 


MacietoshHo 


Recent items 
Force Quit... 


Steep 
Restart... 
Shut Bown... 


Log Out... 


EXAMINE YOUR NETWORK 
CONNECTION 


LB Click Apple OSX => 
System Preferences. 


If your Macintosh is a home-based system, you will 
probably hook up to the network using a dial-up or DSL 
connection. If your Macintosh is on your desk at work, you 
will probably hook up to network wiring that is installed 
throughout your building. After you are connected, you can 
use all the services of the Internet from the classics, such as 
telnet and ftp, to Web surfing and more. 


Home-based systems almost always rely on technology that 
automatically assigns an address to the system and directs it 
to a name server and router that allows it to reach other 
systems. Although these topics are not covered in depth in 
this chapter, you should know the names of these services. 
Dynamic Host Configuration Protocol (DHCP) dynamically 
assigns IP addresses to its client systems. Domain Name 
System (DNS) allows you to look up domain names, such as 
www.apple.com, and retrieve their IP addresses. 


|. Show Alt Displays Sound Network Startup Disk 


Personal 


= ® 1 & 


Desktop Dock International Login items MyAccount Screen Effects 


VE 
Cis &DVDs = CoforSync Keyboard Mouse 


Internet & Network 


QuickTime Sharing 


System 


mea @m *t @ ®@ 


Accounts Classic Date & Time Software Speech Startup Disk = Universal 
date Access 


@ Your dial-up connection is 
established. 


@ The System Preferences 
window opens. 


V4 Select Network under 
Internet & Network. 


WORK WITH INTERNET COMMANDS 


Connecting to the Internet allows you to take advantage of a 
wealth of information and services. Understanding the basics of 
how this connection works will make it easier for you to report on 
and resolve problems when they occur. 


For dial-up accounts, you generally do not need to be concerned 
about the IP address, subnet mask, DNS server, or default router that 
your system will use. Although this information is critical to your 
network connection, your Internet service provider (ISP) assigns it 
when you connect. If your Macintosh is attached to a local area 
network, you might use a static IP address — one that is permanently 
assigned to your system — or one that a DHCP server assigns when 
you boot your system. 


Regardless of how this information is assigned, your system requires 
a unique IP address to identify it as a member of a network, a 
subnet mask to allow the system to determine the extent of the 


local network, a default router to direct remote connections, and a 
DNS server to allow you to locate systems by name. 


System Preferences Edit View Window Help System Preferences Edit View Window Help 


« @&@ 2 | <« wa 


| Show A" Displays Sound Network Startup Disk Show AN { Displays Sound Network Startup Disk 


= AppleTatk } Proxies 


oribekarnornrenstowmanensnrsnonan seen don MOH RAOHAS AAC RCET CHEN EAOPENEYRAESMIERIRIRR RONCHI 


Mi Connect using PoE 


Service Provider: | 


10.16,10.10 Account Name: 


Subnet Mask: }:255.255.255.0 } : : Password: | ecsseece 


Search Domains {Optional} PPPRof Service Name: | 


Router: | 
dragonflyditch.com 


cal Save password 
Checking this box allows aff users of this computer to 
; Sccens this internet account without entering a password. 
Example: apple.com 
fthernet Address: 00:0a:27:d8:53:e6 earthiink. net 


Sonne —c @ You will be prompted to SETUP A DIAL-UP CONNECTION = You will be prompted to 
save the information upon Tl Click the PPPoE tab. save the information upon 


i Enter your IP Address and _Closing the form. closing the form. 


Z4 Type the information 


Subnet Mask on the TCP/IP @ Check with 

your system , 
tab. administrator if you are Re aac Oulbya eager 
2 Enter your DNS Servers unsure about these settings. 


and domains. 


LOOK UP AN INTERNET ADDRESS 


reach a system over the Internet. The command you 

use to look up an address is nslookup. To use this 
command effectively, you need to know about IP addresses 
and name translation. 


Y= can look up an IP address to verify that you can 


A local area network might, for example, include all of the 
IP addresses between 128.2.10.1 and 128.2.10.254. On such 
a network, an address such as 128.2.10.13 functions much 
like a street address. 


A subnet mask is a value of the form 255.255.255.0 that 
numerically marks the dividing line between the portion of 
an IP address that identifies the network and the portion 
that identifies a particular system or host. When a netmask 
contains only values of 255 and 0, this dividing line is easy 
to determine — it is the point at which the values change 
from 255 to 0. If the network portion of an address were 
the street, the host portion of the address would be the 


@ Terminal File Edit Scrofiback Font Window Help 


[ferro:~] users] nslookup | 
Default Server: sysia.coretel net 
Address: 162 .33.16@, 106 


Note: You must be connected to the 
Internet for this task. 


#I The screen displays the 
name and/or address of the 
DNS server servicing your 


In the Terminal window, system. 


type nslookup and press 
Return. 


136 


(ferro:~] user® nslookup | : 


> waw, apple.com 


wf”) Name 
# 


house number. A subnet mask allows a system to determine 
when systems are on the same network and when they are 
not. When the network portions of two IP addresses are 
different, the systems are not on the same network. The 
default router is a system on the local network that 
forwards communications to remote systems — systems not 
on the local network. 


While all of these addresses are essential for network 
connections, it is more convenient to use fully qualified 
domain names such as www.apple.com to communicate on 
the Internet instead of IP addresses such as 17.254.0.91. For 
this to be possible, you need to use a service that translates 
names into IP addresses and vice versa. The service that 
translates between domain names and IP addresses is called 
the Domain Name System and is generally referred to as 
DNS. The nslookup command allows you to make use of 
DNS services on the command line. 


LOOK UP AN INTERNET ADDRESS 
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Defauit Server: sysia.coretel.net 


Address: 162.33.160.108 


Server: sysla.coretel. net 
Address: 162,33,160.100 


Non-authoritative answer: 

wae. apple.com. akadns net 
Address:| 17.254.0.91 
Aliases:] wwre.apple.com 


>O 


The screen displays the IP 
address for that URL. 


Type a fully qualified host 
name and press Return. 


WORK WITH INTERNET COMMANDS 


You can only use the Internet effectively if your system makes use of DNS. 
Servers are able to resolve domain names into IP addresses and IP addresses 
back into domain names only because records containing this information 
have been established and made available through the distributed lookup 
service known as DNS. If DNS records have not been established for a 
system, you will only be able to locate that system over the Internet if you 
know its IP address. A system that DNS knows about is said to be registered. 


No DNS server knows about every system that is registered. Instead, each 
knows about locally registered systems for which it is said to be 
authoritative. However, DNS servers also know how to communicate with 
other DNS servers, so that lookup requests can be answered regardless of 
how remote the system and the DNS server might be. 


Although few users are aware of the activity of DNS, they use the service 
every time they make a connection to a remote system or browse to a Web 
site. To examine where your system looks for DNS services, use the cat 
command to display the file /etc/resolv.conf where this information is stored. 


Terminal File Edit Scroliback 


‘[ferro:~] user% nslookup 
Default Server: sysia.coretel.net 
Address: 162.33.160.100 


> ww. apple.com 
Server: sysla.coretelt.net 
Address: 162.33.168.100 


Non-authoritative answer: 

Nome ; wow. opple.com, akadns .net 
Address: 17.254.@.91 

Aliases: wew.apple,com 


> 17.254.0,91 


Server: sysla.coretel.net 
Address: 162.33.160.100 


Name : wrw. apple.com 
Address:| 17,254.6.91 


>O 


<4 Type the returned IP 
address and press Return. 


[ferro:~] cat /etc/resolv.conft 


Font Window Help 


The screen displays the 
domain name of the IP 
address you entered. 


The content of the resolv.conf file 
showing DNS configuration data 
is displayed. 
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‘[ferro:~} user% 7s Lookup 


Default Server: sysila.coretel net 
Address: 162.33.160, 180 


> ww. apple.com 
Server; sysia.coretel .net 
Address: 162.33.160.10@ 


Non-authoritative answer: 

Name : waw. apple.com, akadns .net 
Address: 17.254.0.91 

Aliases: wew.apple.cam 


> 17.254.8.91 
Server: sysic,coretel.net 
Address: 162.33,.160.180 


Name : yaw. apple.com 
Address: 17.254.0.912 


[ferra:~] user® [] 


@ Your nslookup session 
terminates. 


&4| Type exit and press 
Return. 


LOOK UP DOMAIN INFORMATION 


ou can gather quite a bit of information about a 

domain by using the nslookup or the whois 

commands. These commands provide information 
that can be helpful if you want to know how to reach 
someone responsible for a domain. Such information can 
also be useful in troubleshooting. 


The primary function of DNS is to return IP addresses 

in exchange for fully qualified domain names such as 
www.apple.com. The secondary function is to return fully 
qualified domain names in exchange for IP addresses. 
These, however, are only the most obvious services that 
DNS provides to the systems that use the service around 
the clock and around the globe. DNS also provides several 
other useful functions. For example, DNS maintains and can 
provide information about a domain and its registration. 


You can retrieve information about a domain by requesting 
the statement of authority (SOA) record with the nslookup 
command. The SOA record includes a statement about the 


server's zone of authority — what information it can vouch 
for — and usually provides a point of contact. It also 
contains the serial number and information about when 
zone information expires. 


The DNS mail exchanger (MX) record identifies the mail 
servers for the domain. These records determine which 
systems are contacted when another system needs to deliver 
e-mail to someone with an address at that domain. You can 
also get this information using the nslookup command. 


The whois command looks up information in the Network 
Information Center (NIC) database. This information 
includes the registrar and the name servers responsible for 
the registration. If you are curious about a domain that has 
a name similar to your own or you want to determine 
whether you can buy it, the whois command will provide 
you with some basic information. 


LOOK UP DOMAIN INFORMATION 
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[whois Japple. cond [] 


Note: You must be connected to the 
Internet for this task. 


Type the name of a 
domain and press Return. 


£B Type whois followed by a 
space. 


oo ° 
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Whois Server Version 1.3 


Domain names in the .com, .net, and .org domains can now be registered 
with many different competing registrars. Go to http; //www.internic.net 
for detailed information. 


Domain Name: APPLE.COM 

Registrar; NETWORK SOLUTIONS, INC. 

Whois Server: whois.networksolutions. com 
Referral URL; http://www. networksolutians .com 
Name Server; NSERVER2Z. APPLE.COM 

Name Server: NSERVER.EURO. APPLE.COM 

Name Server: NSERVER. APPLE.COM 

Name Server: NSERVER.ASIA. APPLE.COM 

Updated Date: 13-dec-2002 


>>> Last update of whois datahose: Thu, 2 Jon 2003 5:11:45 EST «<<< 


The Registry database contains ONLY .COM, .NET, .ORG, .EDU domains and 
Registrars, 


(ferro:screenshots] user% [] 


The screen displays the 
NIC information for the 
specified domain. 


DNS records include those defined in the table below. 


RECORD TYPE 


FUNCTION 


Maps a domain name to an IP address 


Provides an alternate name or alias for a system 


Maps an IP address to a domain name 


Identifies a mail exchanger for a domain 


Provides information about the domain as a whole 


WORK WITH INTERNET COMMANDS 


There is not necessarily a one-to-one correspondence between fully 
qualified domain names and IP addresses. A single fully qualified 
domain name can resolve into multiple IP addresses. This indicates that 
connections to these systems are being distributed in such a way that 
each system in the set is responding to a share of the overall traffic. 


A single system may have virtually any number of fully qualified domain 
names, and this is, in fact, often the case with ISPs that provide Web site 
support for hundreds or thousands of customers. For this to work, each 

of these domain names must resolve to the same IP address. 


@ ‘Terminal File Edit Scrofiback font 


Default Server: ‘sySia. coretel net 
Address: 162.33.160.100 


>| Set_querytype=S0A | 
>| waw, apple.com 

sysla.coretel.net 
Address: 162.33.16@.100 
Non-authoritative answer: 
www .apple.com canonical name = ww.apple,com.akadns.net 
Authoritative answers can be found from: 
apple.com.akadns .net 

origin = nsi~159.akom.net 

mail addr = hostmaster. akamai.com 

serial = 50 

refresh = 5@ (5@S) 

retry = 50 (585) 

expire = 58 (50S) 

minimus ttl = 58 (5@5 


Type nslookup and press 
Return. 


Type set querytype=SOA 
and press Return. 
domain. 


Window Help 


EH Type a domain name and 
press Return. 


The screen displays the 
SOA record for the specified 


{ferro:~] user®& ns 
Default Server: 
Address: 162.33.160.100 


ookup 


[f= set_querytype MX 
Es 
Server: sysla.coretel.net 
Address: 162.33.160.100 


Non-authoritative answer: 
apple.com preference 
apple.com preference 


Authoritative answers can be 


apple. 
apple. 
apple. 
apple. 
apple. 
apple, 
mail-in.apple. com 
mail-in.apple.com 


nameserver 
nameserver 
nameserver 
nameserver 
nameserver 


and press Return. 


press Return. 


~ 
s 


Type set querytype=MX 


sysia,coretel .net 


mail-in. eursc.apple.com |) 
mail~in.apple. com 


30, mail exchanger 
16, mail exchanger 


found from: 
nservar4 .apple.com 
nserver .asia.appLle. 
nserver .euro.appLe, 
nserver .apple.com 
nserver2 .apple. com 


nameserver = nserver3.appLle.com 
internet address = 17.254.0.58 
internet address = 17.254.0.57 


The screen displays the 
MxX records for the specified 
domain. 


Type a domain name and 


UNIX FOR MAC 


EXAMINE YOUR NETWORK CONNECTION 


iewing network connection information is especially 

helpful when you are troubleshooting connection 

problems. For example, you can check if your network 
connection is running or determine your netmask with the 
ifconfig command. You can examine your network 
connections, view the state of your network interfaces, 
determine what connections are established, and form an 
idea of how well your network connections are performing. 


All networked Unix systems have at least two network 
connections. One is the normal connection associated 
with the network adaptor and used to communicate with 
other systems. The other is called a loopback and provides 
the means for a system to use network protocols while 
communicating with itself. The loopback address is 
associated with the same IP address on every Unix system. 
That address is 127.0.0.1. The normal or network IP address 
is different on every system and, if dynamically assigned, 
might also be different each time a system connects to 

the network. 


Both network connections serve an important function and 
you can examine both with the ifconfig command. The 
ifconfig — interface configuration — command provides 
information on the network interfaces established on a 
system. This information includes what addresses are 
assigned to each interface and whether the network interface 
is operational. The ifconfig command also displays the 
subnet mask associated with your network connection. This 
information is critical to proper functioning on a network, 
both for proper functioning on the local network and the 
ability to communicate over the Internet. 


Another informative command for examining your network 
connections is netstat. This command provides a listing 
of your routing table — a table used in directing network 
traffic — and details about current network connections as 
well as network statistics that provide insight about how 
well your network connection is working. This includes how 
busy your network interface is and what types of traffic 
your system is handling. 


EXAMINE YOUR NETWORK CONNECTION 
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anet6 ::1 prefixlen 128 
inet6 fe8G::1%10@ prefixlen 64 scapeid @x1 
inet 127.8.@,1 netmask @xff90ee0e 
gif@: flags=8010<POINTOPOINT ,MULTICAST> mtu 1280 
ty: Flags-D<> mtu a 


inekG fest: 20a: 27FF, roti 53e6%end ronatsice 64 cadets @x4 

inet 10.0.8.3 netmask O@xff@08000 broadcast 10,.255.255.255 

ether 00:80:27: d8:53:e6 

media: autoselect (100baseTX <half-duplex) status: active : 
pare media; none autoselect Soe <hal f - -duplex> 1@baseT/UTP 


dup p p 
-loepback 10@baseTX <half- pied 100baseTX <hal f- tuples, hw- Loopback» 10@baseT | 
x dt on an 1é@baseTx Se ite Bea 


USING IFCONFIG The loopback interface, 


dial-up IP address, and 
network interface addresses 
appear. Both interfaces are 
operational. 


Note: You must be connected to the 
Internet for this task. 


LN Type ifconfig and press 
Return. 


140 
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Gateway Flags Refs Use Netif Expir 


default 162 .33.163.7 UGSc 3 21 ~— pppe 

10 Link#4 ucs U1) r) end PIN 
16.0.6.3 127.0.0.1 UHS @ 9 108 

127.0.0.1 127.0.0.1 UH A 5016 108 

162.33.163.7 162 ..33,116.237 UH 4 ®@ pppoe 

169.254 Linked ucs .) ® end 

Internet6: 

Destination Gateway Flags 


Netif Expire 


toe 
FeBO: :¥L08/64 


Link#1 


USING NETSTAT 74 Type -rn and press Return. 


ill Type netstat followed by a 
space. 


I The screen displays a 
listing of your routing table 
with IP addresses. 


Active Internet connections 


Proto Recv-Q Send-Q 
@ 


~~) 


Pe oe oo oo © 


Type netstat -a followed 


by a space. 


Unix systems, especially those 
that are servers, generally 
have many established 
connections at any point in 
time. At each end of a 
connection, a system is 
communicating via a port. A 
port is an address associated 
with a service requester on 
the client end and a service 
on the server end. Ports 
enable software such as 
Microsoft's Internet Explorer 
to communicate with a 
service such as Apache. 


The netstat command 
allows you to view which 
systems are communicating 
and which ports they are 
using in the process. 


Window Help 


including servers) 
Local Address Foreign Address 
lecalhost . 1033 localhost . 1009 


localhost .1009 localhost .1033 


WORK WITH INTERNET COMMANDS 


Network connections are based on TCP. TCP is one of the primary 
protocols making up TCP/IP and the one that almost all network tools 
use. Network connections run through a series of states starting from 
the initial connection request and ending with its closure. Ports on 
servers listen for requests. When a client request arrives, the client and 
server exchange information and a connection is established. You can 
view established connections using anetstat command. 


Information provided by the netstat -a command includes the 
names or addresses of the systems at both ends of each connection as 
well as the port or service address that is being used. Viewing netstat 
output can help you determine how many connections your system is 
supporting and how well it is performing under the load. 


RESULT: 


The screen displays 
a list of established 
connections. 


TYPE THIS: 


[ferro:~] netstat -a | grep ESTABLISHED . 
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Scrollback Font 
" aed “ 


[ferro:~] user% [netstat -s]T more] 


5759 packets sent 
5283 data packets (873485 bytes) 
@ data packets (® bytes) retransmitted 
@ resends initiated by MTU discovery 
35@ ack-only packets (173 delayed) 
@ URG only packets 


sonmromenn aa 


22 
a * 
* 


localhost .1633 


sk 
-*s 
. 


localhost . 1019 


@ window probe packets 
@ window update packets 
126 control packets 


FeSS esc 9 


localhost .1619 localhost , 1033 
localhost .ipp 

* telnet 

* ftp 

lecalhost , 1033 

+5953 

* domain 

®* .bootpc 

* 49158 


Type | more and press 


Return. 


The screen displays a 
listing of your current 
network connections. 


Mane apnpaNARTIBUY gop pti mre ROUEN, 


5563 packets received 
5263 acks (for 873528 bytes) 
44 duplicate acks 
@ acks for unsent data 
5092 packets (474806 bytes) received in-sequence 
@ completely duplicate packets (@ bytes) 
8 old duplicate packets 
@ packets with some dup. data (@ bytes duped) 
@ out-of-order packets (® bytes) 
@ packets (@ bytes) of data after window 
@ window probes 


pve arenes psec uas sane 


B The screen displays a 
listing of your network 
statistics. 


Type netstat -s followed 
by a space. 


Type | more and press 
Return. 


CHECK THAT ANOTHER 


COMPUTER IS REACHABLE 


ou can check whether a remote system is reachable 

using the ping command, and trace routes using 

traceroute. Whenever you have trouble making a 
connection to a system, you can test the connection using 
ping — a deceptively simple command that sends a small 
request in the form of a packet to the remote system, 
requesting a reply. The ping command was named after 
the sound that sonar makes when locating an object. 


If the remote system is running and capable of replying, it 
responds to the request that ping generates, and you see 
the response on your screen. On Mac OS X systems, ping 
generates requests until you press Control + C. Then it 
displays a summary of the responses, including how many 
requests the remote system answered and how long each 
round trip took. This reply tells you whether you were able 
to reach the remote system and indicates the quality of the 


connection. If your system receives a reply for every 
request, you probably have a good connection. 


Another useful command for testing network connections is 
traceroute. The traceroute command attempts to time 
the connection between your system and each successive 
router in the route between you and the target host. The 
result is a list of each hop, along with reports on how long it 
took to reach each system. This timing information can be 
used to interpret the quality of the connection. 


Both ping and traceroute rely on a protocol called the 
Internet Control Message Protocol (ICMP) that is sometimes 
blocked on routers. Because of this blocking, you might 

get inaccurate results if you ping or run traceroute on 

a system. The results may suggest that the system is 
unreachable, but you may be able to reach it with a 
telnet or ssh command. 


CHECK THAT ANOTHER COMPUTER IS REACHABLE 
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: 

.apple,com.akadns.net C1?7.112.152.32}: S56 date bytes 
from 17.112.152.32: icmp_seq-@ ttl=48 time=185.225 ms 
from 17.112.152.32: icmp_seq=1 ttl=48 time=191,329 ms 
from 17,112,152.32: icmp_seq=2 tt1=48 time=185.518 ms 
from 17.11Z2.152.32: icmp_seq=3 ttl=48 time=177.493 ms 
from 17. «152.32: icmp_seq=4 ttl=48 time=175.085 ms 
from 17.112.152,32: icmp_seq=5 tt1=48 time=176.68 ms 
from 17.112,152.32: icmp_seq=6 tt1l=48 time=178.282 ms 
from 17.112.152.32: iemp_seq=7 ttl=48 time=174.883 ms 
from 17.112.152.32: icmp_seg=8 tti=48 time=179.485 ms 
from 17. .152.32: icmp_seq=9 ttl=48 time=176,087 ms 


wow Ww. apple.com.akadns.net ping statistics »-- 


1@ packets transmtted,|18 packets received, @% packet Loss 


round-trip min/avg/max = i74. Gt ors 


[ferro:screenshots] users [} 


Note: You must be connected to the KY Press Control + C after 


Internet for this task. 


The ping command 
displays a summary of its 
responses. 


a Type ping followed by a 
space. 


P4 Type the domain name of 
a remote system and press 
Return. 


No packets were lost or 
unanswered. 


waiting 10 seconds or more. space. 
and press Return. 


waiting 10 seconds or more. 
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6 data bytes 


=~ ww. microsoft.akadns net ping statistics --- 


1@ packets transmitted,|@ packets received, 18@% packet loss 
U 


[ferro:screenshots] user? 


@ The ping command 
displays a summary of its 
responses. 


Type ping followed by a 


Type www.microsoft.com 
Mi If no replies were received, 
the ICMP protocol is 


Press Control + C after probably being blocked. 


el 


Terminal 


Type traceroute followed 
by a space. 


Type the domain name of 


File Edit 


You can often make your 
troubleshooting easier by reducing 

the complexity of your commands. Like 
many networking commands, ping 
relies on the services of DNS to resolve 
domain names into IP addresses. If you 
are having trouble reaching your DNS 
server, your ping and traceroute 
commands will be affected. To rule out 
name resolution when you are 
troubleshooting a network connection, 
use ping and traceroute with an IP 
address instead of a domain name. Of 
course, this only works if you know the 
IP addresses for the systems you want 
to reach. 


Similarly, commands such as netstat 
usually run faster if they are not 


required to look up IP addresses and 
translate port addresses into names. 
You can turn off lookups by adding n 
to the argument list. 


Scroiiback Font Window Help 


with a header line and a 
single route timing line. 


a system on the same network 
as your computer, or the IP 
address of your default 


gateway. 


Traceroute responds 


WORK WITH INTERNET COMMANDS 


TYPE THIS: 


ping 192.74.137.5 


Vv 


RESULT: 


PING 192.74.137.5 (192.74.137.5): 56 data bytes 
64 bytes from 192.74.137.5: icmp_seqg=0 ttl=240 time=157.03 ms 
64 bytes from 192.74.137.5: icmp_seq=1 ttl=240 time=166.589 ms 


a0 

— 192.74.137.5 ping statistics —- 

2 packets transmitted, 2 packets received, 0% packet loss 
round-trip min/avg/max = 131.532/157.241/191.94 ms 


TYPE THIS: 


netstat -an | grep ESTABLISHED 


Vv 
RESULT: 


[ferro:screenshots] user% netstat ~a | grep ESTABLISHED 
tcp4 0 0 east-18-34.dynam.49218 fajita.toad. 
net .http ESTABLISHED 


Terminal File Edit Serofiback Font Window Help 


traceroute to wew. apple.com. akad .32), 30 hops max, 4@ byte pa a 
ckets 
1 geese.coretei net €162.33.163.17} 115.781 ms 99.487 ms 118.174 ms 
2) 162.33.163.1 (162.33.163.1) 103.565 ms 98.942 ms 101,54 ms 
3. hsrp-dmvptp.colo.coretel net (162.33.163.103) 104.714 ms 106.687 ms 163. 
346 ms ; 
4 7585~-dmvptp.colo.coretel net (162,33.163.1@Z) 100.405 ms 101.796 ms 101. 
757 ms 
12.119.78.9? €12.119.78.97) 131.474 ms 187.583 ms 187.94 ms 
gbr5-p59.wswde.ip.att.net (12.123.194.66) 111.968 ms 106.495 ms 189.289 


gbr3~p100.wswdc.ip.att.net (12.122.5.194) 108.253 ms 104.758 ms 106.499 


gbr3-p48.s19m0.ip.att.net (12.122.2.82) 172.125 ms 118.393 ms 124.247 ms} 
gbr3~p20.sffca.ip.att.net (12.122.2.74) 164.742 ms 160.726 ms 165.341 ms 
gori-p5@.sffca.ip.att.net (12.122.1.162) 169.76 ms 162.623 ms 161.464 ms 
garl-p360.sffca.ip.att.net (12,123.13.57) 164.633 ms 257.139 ms 159.378 


Traceroute returns lines 
of data describing the route 
taken to reach the remote 
system. 


Type traceroute followed 
by a space. 


Type the domain name of 
a remote system and press 
Return. Wi An asterisk in place of a 
time means that the response 
did not come back in time to 
be counted. 
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LOG ON TO ANOTHER COMPUTER 


on other systems. You can log on to a remote system 

using telnet or rlogin. Unix systems, such as 
Mac OS X, provide several ways for you to log on to other 
systems. The most established of these is a tool called 
telnet that has been available longer than the Internet. 
Telnet establishes a terminal-like connection to another 
system. If the remote system has telnet services enabled, 
it asks you for a username and password and logs you on. 


y ou can take advantage of accounts and applications 


Most telnet servers give you the option of logging on 
with the username you are using on your local system, 
but you are free to enter a different username at the 
prompt. You end a telnet session by logging out. For 
most systems, you can press Control + D or type the 
command logoff to exit. 


LOG ON TO ANOTHER COMPUTER 


Another tool for logging on to remote systems is rlogin. 
This tool is much like telnet, but less common. You are 
likely to find it only on Unix systems, and even then, it may 
be disabled. The rlogin command requires that you log 
on with the same username that you are using on the local 
system unless you add the -1 newname argument to the 
end of the command. 


To use any of these tools, you must have an account on a 
remote system. If you do not have a shell account on another 
system, however, you can try telnet or rlogin by logging 
on to your Mac OS X system. The logon will only work if you 
have enabled remote access. See the section "Enable Remote 
Access to Your Computer" later in this chapter. 


Terminal File Edit Scroliback Font Window Help 


s i OSE Sree i 
(Ferra: screenshots) userx 
Trying 205.244.232.4... 
Connected to achilles.tcsnet.net. 
Escape character is *4}*, 


ih 


Sun0S 5.8 


Pas sword: 
Lost login: Sun Dec 29 19:39:52 from cord-eagt-5-26. 
bash~2.03$ [} 


USING TELNET 4 Type the domain name of 


a system on which you have 
a shell account. 


Note: You must be connected to the 
Internet for this task. 


Note: Type telnet locathost if you do 
not have a remote system account. 


BB In the Terminal window, 
type telnet followed by a 
space. 


|6—6vrsxKB 


Type your username and 


password at the prompts. 
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Poush-2.038[who ami] 


bash-2.03$ [} 


Type who ami and press 
Return if the remote system is 
a Unix host. 


The screen displays your 
logon on the list of logged on 
users. 


You can use telnet to test 
connections to other 
systems by supplying a port 
number in addition to the 
system name on the 
command line. If you want 
to check how many 
messages are in your inbox 
on a system that supports 
POP3, you can connect to 
the port that services the 
POP3 server and ask for this 
information using telnet. 
You can also use telnet to 
determine whether a mail 
server is responding. POP3 
is a simple protocol used to 
download e-mail from the 
mail server. 


Ferminal File Edit Scroilback Font Window Help 


og 
bash-2.83$ [] 


USING RLOGIN Z| Type the name or IP 


# in a Terminal window, 
type rlogin followed by a 
space. 


and press Return. 


log on. 


address of the remote system 


4 Type your password to 


WORK WITH INTERNET COMMANDS 


{ferro:~] telnet <servername> 110 


Use the name of a server from which you receive 
e-mail using POP3. After the system responds, 
enter the following lines, replacing the text in 
brackets with your account information: 


user <your username> 
pass <your password> 
stat 


quit 


Ww 


After the stat command, the system displays a 
number telling you how many messages are in 
your inbox. 


[ @& Terminal File Edit Scroliback font Window Help 


Sa 


[ferro:~] user% rlogin achiltes,tcsnet.net 
Password: 
Last login: Thu Jan 2 11:22:27 from achilles 


LOG OFF 


ai Type logout and press Control + D. 


Return. 
you off. 


Note: Alternatively, you can press 


The remote system logs 


TRANSFER FILES 


ou can often obtain needed files and applications 

from other systems. You can move files between your 

system and others using ftp. Approximately as old as 
telnet, the ftp command has been enabling Unix users 
to upload and download files for a couple of decades. The 
protocol, or language, of £tp is fairly simple, although some 
ftp servers have implemented a wide range of commands. 


In its simplest form, ftp allows you to log on to a system, 
upload files using the put command, download files using 
the get command, and move around the directory 
structure on the remote system. You can transfer data in 
binary mode or ASCII mode. ASCII mode is designed for 
text files, and ftp translates line endings if you are 
transferring text files between Unix and DOS systems. 
Binary mode is designed for software, image files, and other 
types of files that use non-printable characters that might 
otherwise interfere with the transfer. 


One popular form of ftp is called anonymous ftp. When 
using anonymous ftp, you type the word anonymous as if 
it were your username and your e-mail address (or 
sometimes any string of characters) as your password. 
Anonymous ftp allows people who do not have accounts 
on a system to upload or download files. For example, if 
you set up a drop box for your customers to upload error 
logs so you can analyze problems they are having with 
software you sold them, you might chose anonymous ftp. 
Many companies, such as Apple, that provide 
documentation and software tools to their customers do so 
using anonymous ftp. 


You should cd into the directory in which you want 
downloaded files stored before you start your ftp session. 
Like telnet, ftp is not enabled as a service on Mac OS X 
when you first install the operating system. 


TRANSFER FILES 


A Terminat File Edit Scroiiback Font Window Help aq 


Connected to world. std. com. 
220 world.std.com FIP server (Version wu-2.611(5)} Mon May 21 20:22:19 EDT 2001)> 
ready. 

Name (world. std.com:shs): 
331 Password required for slee. 
Password:| | 

236 User stee Togged in. 
Remote system type is UNIX. 


Using binary mode to transfer files. 
ftp> [] 


Note: You must be connected to the 
Internet for this task. 


74 Type the name of the 
system from which you want 
to download files and press 


LB Type ftp followed by a Return. 


space. 


kJ Type your username and 
password at the prompts and 
press Return. 


Terminal File Edit 


Seroliback Font 


Window Help 


(ferro:~] user® ftp world. std.com 
Connected to world.std.com. 

220 world.std.com FTP server (Version wu-2.6.1(5) Mon May 21 20:22:19 EDT 2001) 
ready. 

Name (world. std.com:shs): slee 

331 Password required for slee. 


qa system type is UNIX. 


‘ee 
binary mode to transfer files. —_ 


t yo.txt remote: yo.txt 
5@6 ‘EPSV’: command not understood. 

227 Entering Passive Mode (192,74,137,5,30, 208) 
159 Opening ASCII mode dato connection for yo.txt (® bytes). 

180% | FFPEROR ESE SAESEAERE SERRE ERE RE TE HEED] 7 0.03 KB/s 
226 Transfer complete. 

? bytes received in @6:0@ (8.02 KB/s) 


8.08 ETA | 


4 Type ascii and press The file downloads. 


Return. 


Ey} Type get, a space, the 
name of a text file, and then 
press Return. 


WORK WITH INTERNET COMMANDS 


You will have an easier time figuring out what went wrong in a file transfer if you know 
what to look for. Files that you download incorrectly will have problems. Binary files that 
you transfer as if they are text files are likely to be corrupt and probably unusable. If you 
attempt to display or otherwise use the files, the system will display an error message. 


Text files that you download as binary are likely to be fine if you download them from 
another Unix system. However, a text file that you download in binary mode from a 
Windows system is likely to have an extra character at the end of every line. This character 
represents the carriage return that Unix systems do not use. It displays as *M when you 


open these files with an editor. 


Example: 
Making Better Use of Ping”M 
“M 


Long one of the system administrator's favorite tools for*M 


troubleshooting network-related problems, 


ping is used*M 


You can remove these unwanted characters using the Unix tr command. 


Example: 


[ferro:~}] cat textfile | tr -d "\015" > textfiless 


[ferro:~] mv textfilesS$ textfile 
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cs 


238 User slee logged in. 

Remote system type is UNIX. 

Using binary mode to transfer files. 

ftp> ascii 

208 Type set to A. 

ftp> get yo.txt 

local: yo.txt remote: yo. txt 

5@0 ‘EPSY'; command not understoad. 

227 Entering Passive Mode (192,74,137,5,131,119) 

15@ Opening ASCII mode data connection for yo.txt (6 bytes). 
160% [ PAOCReeSeseretehseeeee eat Cethees sew) Z 8.83 KB/s 


00:00 ETA 
226 Transfer complete. : 


15@ Opening SINARY made data connection for flee.2 (583167 bytes). 


160% [ FORERRA RENO REHE CR ERE RE RERREEEETRORHD | 
226 Transfer complete. 

583167 bytes received in 03:16 (2.90 KB/s) 
ftp> [J 


569 KB 2.98 KB/s 


J] Type binary and press 
Return. 


(@ Type get, a space, the 
name of a binary file, and 
then press Return. 


@ The file downloads. 


USING ANONYMOUS FTP 
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{[Fte_ftp.apple con] 
Trying 17.254.8.26.° 
Connected to ftp.apple.com. 
220 ProFTPD 1.2.1 Server (Apple Computer Anonymous FIP Server) (ftp@6} 
Name P.apple. com: user): | anorymous | 
331 Anonymous login ok, send your Complete email address as your password, 
Password: 
230 Anonymous access granted, restrictions apply. 
Remote system type is UNIX. 

ing binary mode to transfer files. 


drwxrwxp -x 
drwexraxr~x 
drwxrwxr-x 
drwxrwar-x 2 ftp 
drwxpwxp-x 18 ftp 
226 Transfer complete. 


6 ftp 
12 ftp 
8 ftp 


13 2802 Apple_Support_Area 
2@ 19:48 developer 
22 22:53 filemaker 
18 2001 quicktime 
@ 12 1999 research 


<4] Type Is and press Return. 


ui Type ftp ftp apple.com and 


fs Wi The system displays a list 
press Return. 


of directories. 


Z4, Type anonymous at the 
login prompt and your e-mail 
address at the password 
prompt, each time pressing 
Return. 


aul Type bye and press Return 
to log off. 


ACCESS ANOTHER COMPUTER SECURELY 


with telnet by using ssh. The telnet, rlogin, and 

£tp commands have a long-recognized vulnerability. 
Each of these commands transmits usernames and 
passwords in clear text. Anyone situated along the network 
path between you and the system you are logging on to and 
capable of "sniffing" packets — capturing network traffic 
intended for another system — could capture your logon 
information and use your account. For this reason, secure 
tools have been created that provide remote logon access 
and file transfer without exposing username and password 
information. These tools use a process known as encryption 
to make the network traffic between client and server 
indecipherable. 


Y« can log on to a remote system more securely than 


To use ssh in place of telnet or rlogin, you need to 
have access to an ssh command or a tool that uses ssh, 
and the server that you want to connect to must have an 


ssh server such as sshd. For some ssh connections, you 
will log on with username/password pairs. For others, you 
may be provided with a digital certificate. If your username 
is not the same on both systems, you must use the —1 
option. 


From a user's point of view, using ssh in place of telnet or 
rlogin makes little difference. The process and the result 
are nearly the same, especially if the user logs on with a 
username and password. The encryption and decryption 
securing the transferred information is completely 
transparent. When digital certificates are installed on the 
client and server end of a connection, the process of logging 
on may be simplified even further. However, the logon only 
works on systems that have had the certificates installed. 


Similarly, you can use sftp in place of ftp to securely 
transfer files. When you use sftp, the files you download 
are encrypted during the download. 


ACCESS ANOTHER COMPUTER SECURELY 


Terminat File Edit 


Scraliback Font Window Heip 


Sun ic raueaaale Inc. 
bash-2.03$ [] 


LOG ON WITH SSH 


Note: You must be connected to the 
Internet for these tasks. 


4, Type the name of a 
server for which you have an 
account and that has an ssh 
server running, and press 
Return. 


Bi Type ssh followed by a 


space. Ej} Type your password at the 


prompts. 


M@ You are logged on to the 


LOG ON WHEN YOUR 
USERNAMES DO NOT MATCH 


space. 


the remote system followed 
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ssh -U]stee world. std. con 
lpioaetl 


slee@world, std. com § password: 


of fi ce@}heWor1d. com 
617473948202 


Account: 
Support: 


No mail. 

TERM = (vt1@@) 
Erase is delete 
Kill is_control-U 
worlds [] 


<j, Type the name of the 
remote system and press 
Return. 


ul Type ssh -I followed by a 


ZY Type your password at the 


Y4 Type your username for prompt and press Return. 


@ You are logged on to the 


by a space. server. 


16 | server, 


WORK WITH INTERNET COMMANDS 


If you need a file that is on a remote system and 
your are limited to using secure connections, you 
can still download files, but you must use sftp 
instead of ftp. When you use sftp, your download 
files are encrypted between the remote server and 
your system, making it safer to download sensitive 
files. You can download a file using sftp in the way 


just described or by entering a one-line command 
in a Terminal window. Type the line shown below, 
replacing the portions of the command in brackets 
with your data. 


Example: 


[ferro:~] user’ sftp user@remote.system.net: 
/home/user /myfile.txt 


Connecting to remote.system.net... 
user@remote.system.net's password: 
Fetching /home/user/myfile.txt to myfile.txt 


Terminal File Edit Scrollback Font Window Help 


Paes 


'[ferro:~] user% sftp ferro@achilles. tcsnet. net 
Connecting to achilles.tcsnet.net... 
ferro@achilles.tcsnet .net’s password: 


ferro@achilles.tcsnet.met's password:| | 
sftp> (] 
other 512 Jan 

other 4096 Jan i os 

staff 206662 Jan 352 instructions. txt 
staff 55 Jan 352 .bosh_history 


oremee ee aT) 


ete We 8 REARS 


TRANSFER FILES SECURELY KH Type the name of the Type Is and press Return Ld Type the name of a text 
1 remote system and press to display a list of the files in file and press Return to 
Me a i Return. the remote account. download the file. 


space. 


G2 Type your password at the Type get followed by a tJ] Type bye to exit. 


(4 Type your username prompt. space. 


followed by @. 
@ You are logged on with 
sftp. 


DOWNLOAD WEB FILES 


the curl command. Although the most obvious way 

to download a Web page is to type or copy the URL 
in your browser's Address block and use the Save As 
feature, this is not necessarily the easiest or most efficient 
method. Mac OS X includes a command line tool called 
curl — copy URL — for downloading Web pages. Curl 
works with a number of protocols, including HTTP, HTTPS, 
FTP, GOPHER, DICT, TELNET, LDAP, and FILE. 


Y ou can download files with very little effort by using 


Not only does cur1 allow you to download Web pages on 
the command line, but it also allows you to download files 
using curl commands in a script. In fact, you can 
download and install files in a completely unmanned 
fashion. The syntax of the cur1 command is flexible 
enough to allow you to access multiple pages or multiple 
sites with a single command. 


DOWNLOAD WEB FILES 


To use curl, you type curl followed by any of the options 
that you want to specify and the URL string. A command such 
as curl -Ohttp://www.sandrich.com/index.html 
copies the specified file from the specified site to your 
current directory using the same filename. Without the -o, 
the cur1 command downloads the file to your screen and 
presents you with lines of HTML. 


Cur1 allows you to copy more than Web pages. You can 
also use it to download binary files, including image files 
and software. In fact, the command is so efficient that Unix 
tools designed to locate and download applications from 
the Internet often use cur! to do the downloading. You can 
specify multiple URLs or portions of URLs by enclosing 

the strings you want to match within braces. The string 
www.{a,b,c).com, for example refers to the three systems — 
www.a.com, www.b.com, and www.c.com. 


[ @ Terminal File Edit Scroliback Font Window Help a 


#! /bin/tcs 
# copy_file 


ed ~/sre 


{ferro:~] user% chmod a+x copy_file 


COPY A WEB PAGE 


Type -O followed by a 
space. 


Note: You must be connected to the 
Internet for these tasks. Ki Type the URL of a Web 


LE In the Terminal window, page and press Return. 


type curl followed by a space. 


@ The page downloads and 
maintains the same filename. 
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ferro;~] user%|curl |-O[http: //www, sandrich. com/{inde 

pi.htnsl | 

% Total % Received % Xferd Average Spead 
Dload Uptodd Ti 

1005596 «1800 596 @ ® 1297 q @ 

100 «6608 «6100 «8668S @ @ 1248 @ @ 

{ferro:~] users [] 


otal 
128 
128 


COPY A RANGE OF WEB PAGES <j} Type a URL containing a 
EB Type curt followed by a range and press Return. 
space. The specified pages 
download. 


74 Type -O followed by a 
space. 


WORK WITH INTERNET COMMANDS 


Curl can post to Web sites as well as download files of various kinds. 
Posting commands include the name of the script to be executed along 
with the parameters that you would enter in the online form. You need 
to know quite a bit about a form to successfully post to it. The example 
below assumes that the parameters birthyear and vote are being 
collected by the online form. It also assumes that the data is processed 
when a button is pressed and that the value of the press equals OK. 


A post command in curl might look like the following: 
curl -d "birthyear=1985&vote=1&press=OK" www.site.com/vote.cgi 


This type of command can be used in a script to automate posting. 
To learn more about curl and how you can use it in scripts, you can 
read the man page or download a tutorial available online. 


> The httpscripting.html tutorial downloads. 


{ferro:~] curl -O http://curl.planetmirror.com/ 
docs/httpscripting. html 
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- s 


bs 23 
(ferro:~] user® Li 
3.tor.Z 

% Total 


echo -n "URL> ” 
set URL = $< 


{ferro:~] user [] 


DOWNLOAD A BINARY FILE __ EJ) Type the URL of a Web = felt me =i Type echo -n "URL>" and 
Tl Type curl followed by a page containing a PAGES WITH CURL press Return, then type set 


anata compressed tar file and press 
oe Return. 
74 Type -O followed by a 


space Note: On a dial-up connection, this 


may take awhile to download. 


The specified binary file 
downloads. 


| Start the Pico editor to 
create a file named copy_url. 


4) Type #!/bin/tesh and press 
Return twice. 


URL = $< and press Return 
twice. 


Type cd ~/src; curl -O 
http://SURL. 


G Save your file, and exit 
Pico. 
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ENABLE REMOTE ACCESS 


TO YOUR COMPUTER 


ou can allow others to log on to your computer or 

make it possible for you to log on to your Mac OS X 

system from another system.While Mac OS X systems 
make it possible for you to log on to remote systems, 
browse Web sites, and download files, they do not allow 
others to log on to your system or access files on your 
system. If you want to allow this type of access, you have to 
enable it by modifying your system's configuration. 


There are two basic ways to provide a network service on 
your Mac OS X system. You can start the service — for 
example, start up a Web server — by typing the name of the 
server process on the command line. These services are 
designed to run in the background and continue running until 
you shut your system down or kill them. See Chapter 7 for 


ENABLE REMOTE ACCESS TO YOUR COMPUTER 


| 2 | Type your password if 
prompted. 


Be Type sudo vi 
/etc/inetd.conf and 
press Return. 


more information). Alternatively, you can configure the service 
to start whenever a request arrives. In this latter case, another 
process listens for requests on behalf of the service and starts 
it as needed. The decision as to which method to use 
depends on the particular service. Web servers, such as 
Apache's httpd, are better run all of the time. This provides 
better Web performance. Services such as ftp and telnet 
that are used only now and then are better run on an as- 
needed basis. You configure as-needed access through the 
/etc/inetd.conf file. 


To modify system configuration information in Mac OS X, 
you need to be a privileged user. The sudo command, 
which allows you to run a command as root, works well for 
this purpose if you are allowed access. 


Cres 
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@(#)inetd,conf 5.4 (Berkeley) 6/30/90 


Items with double hashes in front (##) are not yet implemented in the 0 


#finger stream tcp nowait nobody /usr/Libexec/tcpd 
ingerd ~s 

#ftp stream tcp 
tpd -1 

#login stream tcp 


nowait root /usr/libexec/tcpd 


nowait root /usr/libexec/tcpd 


stream tcp nowait usenet /usr/libexec/tcpd 


dgram udp wait root /usr/Libexec/tcpd 


stream tcp nowait root /usr/libexec/tcpd 


stream tcp root /usr/Libexec/tcpd 


@ Your cursor is positioned 
at the beginning of the line 
detailing the £tp service. 


| Type AHtp and press 
Return. 
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WORK WITH INTERNET COMMANDS 


Files responsible for the configuration of a 
Unix system, Mac OS X included, are always 
set up so that only the root is able to make 
changes. This is important to system security 
because it ensures that only trusted users can 
modify the configuration of a system. As a 
system manager, you have two choices when 
you need to change a configuration file. You 
can switch users to the root account with the 
su command; su - sets you up as root with 
root's environment. Alternatively, you can 
use the sudo command to run the command 
that only root can run otherwise. 


TYPE THIS: 


[ferro:~] sudo date 
[ferro:~] sudo date 


> 


asks 


Whenever you use the sudo command, you 
are prompted to enter your password to 
ensure that you are the user entrusted with 
sudo privileges and not someone who has 
just walked up to your unattended Terminal 
window. If you enter another command 
shortly afterwards, you do not have to enter 
your password again. The sudo command 
includes a timer that allows you to work for 
five minutes before asking for your password 
again. 


You must be set up as a system administrator 
or listed in the /etc/sudoers file to use sudo. 


RESULT: 


On the first call to sudo, the system 


you to enter your password. 


On the second call, it does not. 
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Internet server configuration database 


@(#inetd.conf 5.4 (Berkeley) 6/30/90 


#finger stream tcp 


ingerd 
ftp 
tpd -L 
#login 
loging 
#nntp 
ntpd 
#ntalk 
talkd 
#shell 
shd 
telnet 


EJ Type x to remove the # 
character below your cursor. 


~s 
stream 


stream 
stream 
dgram 

stream 


stream 


tcp 
tcp 
tcp 
udp 


tep 


Items with double hashes in front C##) are not yet implemented in the 0: 


nowait nobody /usr/libexec/tcpd 


nowait root /usr/lLibexec/tcpd 


nowait raot /usr/Libexec/tcpd 


nowait usenet /usr/Libexec/tepd 
/usr/lLibexec/tcpd 
/usr/libexec/tepd 


/usr/lLibexec/tcpd 


<3 Type :wq and press 
Return. 


followed by the process ID 
for inetd and press Return. 


and press Return. 
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Rfinger stream tcp nowait nobody /usr/libexec/tcpd 
ingerd -s 

ftp stream 
tpd -1 
#login 
lagind 
#nntp 
ntpd 
#ntalk 
talkd 
#shell 
shd 
telnet 


tcp nowait root /usr/libexec/tcpd 


stream tcp nowait root /usr/libexec/tcpd 


stream tcp nowait usenet /usr/libexec/tcpd 


wait root /usr/lLibexec/tcpd 


dgram udp 


stream tcp nowait root /usr/libexec/tepd 
stream tcp nowait root /usr/lLibexec/tcpd 
5? lines, 2542 characters. 


ips -aux | grep inetd 
o. 703: 
= sudo Kill -HUP 318 
{ferro:~] user® |ftp Localhost 


Connected to localhost. 


229 localhost FIP server CLukemftpd 1.1) ready. 
Name (Localhost:shs): [] — 


@ The inetd process reads 
the /etc/inetd.conf file, 
enabling the £tp server. 


??) «Ss 6:27AM 0:00.01 inetd 


J] Type ps -aux | grep inetd 


4 Type sudo kill -HUP 
3 Type ftp localhost and 
press Return. 


The ftp service that you 
just enabled responds to your 
request. 
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INTRODUCTION TO SYSTEM 


ADMINISTRATION 


ou can effectively administer a Mac OS X system by 
learning some basic commands. Unix administration 
is a complex job, but Mac OS X provides many tools 


for making the job manageable. 


TTD 


The basic responsibilities of any Unix system 
administrator are to keep the system running smoothly 
and to ensure that important data and configuration 
files are preserved. To administer a Mac OS X system, 
you need to understand the fundamentals of file 
systems, know how to set up user accounts, recognize 
when the system is having problems, and be prepared 
to manage applications and disk space. 


System administrators routinely back up the systems 
they manage. This allows them to restore files if the 


ACCESS PRIVILEGES 


Critical to the role of a system administrator is the 
concept of privilege. In order to install applications and 
modify configuration files, you need to have access to 
the root or superuser account or to be a privileged user. 
A normal user on a Unix system can only work on files 
in their home directory. 


The root user has virtually unrestricted access to the 
system. As a result, the root user can modify files 


system crashes or if someone mistakenly deletes the 
wrong files from their account. System administrators 
also manage accounts for other users. They establish an 
account for each user and ensure that the user can use 
the tools and applications they need. 


Users in large companies can often rely on help from a 
user support team. If you are using Mac OS X at home 
or in your small business, you are probably responsible 
for managing the system yourself; in effect, you are your 
own system administrator. 


belonging to any user, modify any configuration file, 
and shut the system down or reboot it from the 
command line. 


While the privileges assigned to the root user are most 
significant when a Mac OS X system is managed by one 
person and used by many, use of the root account is 
important even on systems where root and user are one 
and the same person. 


SYSTEM ADMINISTRATION COMMANDS 


a 


Mac OS X is not only different from Mac OS 9 and earlier 
versions of Mac OS, it is also different from other versions 
of Unix. For example, the root user on a Mac OS X system 
is disabled by default. This means that you cannot simply 
adopt the root identity and run commands that you are 


You also need to know the basic file system layout — 
where the system stores files — and you must also know 
whether you should pay attention to the files you find in 
the /etc directory — the normal configuration directory 
on Unix systems. 


not allowed to run as a normal user. Instead, you need to 


either preface these commands with the word sudo, or 
you need to activate the root account. 


COMMAND 


apropos Find related commands. man Present the manual page for a system 
command. 


The table below contains a list of some of the most 
important Mac OS X commands for system administrators. 


MOST COMMON USE COMMAND MOST COMMON USE 


chown Change the owner and, optionally, mount Attach a file system to the system. 
the group of a file. 
compress Compress a file. netstat Look at routing tables, network 
connections, or network statistics. 
crontab -e Edit a cron file. Create a new file system. 
crontab -1l List cron jobs. nidump Display network information from 
NetInfo. 
df Display free and used disk space. Print tables from Netinfo. 
du Display disk space usage. Look up DNS information. 
dump Dump a file system to a passwd Change the password for a user. 
backup device or a file. 
fastboot Reboot the system without a ping Test the connection to a system 
disk check. by asking for a reply. 
fdisk Examine or change DOS ps Display information on running 
partitioning information. processes. 
file Determine the type of a file. Shut down and reboot the system. 
find Find files using particular criteria. shutdown Shut down a system gracefully. 
fsck Check the integrity of a file system. shutdown -r now | Shut down and reboot a system 
immediately. 
gunzip Unzip a file zipped with gzip. strings Display the strings in a binary file. 
gzip Compress a file. tar Create a file archive or read from one. 
halt Shut down a system immediately. top Display statistics on the most demanding 
processes. 
1fCUnEig Display or change network interface touch Update the last changed date on a file 
information. or create an empty file. 
kill Send a signal to a process, umount Unmount a file system which is currently 
possibly terminating it. mounted. 
in Create a symbolic or hard link toa file. | uncompress Uncompress a file compressed with the 
compress command. 
lpq Display a printer queue. 


SHUT DOWN AND RESTART THE COMPUTER 


the command line instead of the Aqua interface if you 

have access privilege. This is useful if you are not 
sitting at the system keyboard. The command to shut down 
Mac OS X is shutdown. Although it is not the only way to 
shut the system down, it is the safest. Using the shutdown 
command allows you to send warning messages to users 
still logged onto the system that you are shutting down the 
system. This gives them time to finish up what they are 
doing and log off. 


VY ou can shut down or restart a Mac OS X system from 


You can specify the time at which the system shuts down by 
entering a time in the yymmddhhmm format, or you can 
enter a number, such as +15, to specify that the system 
shuts down in 15 minutes. 


You can also specify a warning message that appears to 
users. You can tell users that, although the system will be 
shutting down, it will be available again at a specified time. 
For example, the command shutdown +15 "ferro 
must be shut down for emergency service, 
please log off" allows your users to finish work they 
are doing, while letting them know that the system may be 
down for quite a while. 


The halt and reboot commands do not provide users 
with a grace period to complete their work, but terminate 
running processes before the shutdown. Both commands 
have options that change the way they run. For example, 
with a -q argument, both of these commands shut down 
without terminating processes first. 


SHUT DOWN AND RESTART THE COMPUTER 
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[ferro:~] userx [sudo] shutdown] 
Pores 
Shutdown at Tue May 27 89:05:05 2003. 


shutdown: [pid 657] 
(ferro:~] user® 


the system must be shut down 


*** System shutdown message from shs@ferrp.local. *** 


ystem going down in minutes 


the system must be shut down 


SHUT THE SYSTEM DOWN 4x prompt appears, type 
your password, and press 


Return. 


i Type sudo followed by a 
space. 


The system displays a 


74 Type shutdown followed 


by space. five minutes. 


<3 Type +5 "the system must 
be shut down" and press 
Return. 


RESTART THE SYSTEM 


space. 


24) Type reboot and press 


warning and shuts down after Return. 
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<3} Type your password at the 
prompt, and press Return. 


iN Type sudo followed by a 
Mi The system restarts 
immediately. 


S aa sa... cxj_<<" 


SYSTEM ADMINISTRATION COMMANDS 


If you enable the root account, you can shut 
down or restart the system without using the 
sudo command. When you do not have the root 
account enabled, you need the sudo command 
to give you the authority of root while you 
execute the shutdown command. The same is 
true of the reboot and halt commands. Though 
the shutdown, reboot, and halt commands 
may appear simple, there is a lot that happens 
during the shutting down or booting of a system. 
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‘[ferro:~] user%[sudo|halt, 
Lh 


HALT THE SYSTEM 


ui Type sudo followed by a 
space. 


74 Type halt and press 
Return. 


<2 If a prompt appears, type 
your password, and press 
Return. 


@ The system halts 
immediately. 


You can simplify the process of restarting or halting 
a system by using the fastboot or fasthalt 
commands. These commands save time in the boot 
and halt processes, respectively, by skipping the 
process of checking your disks for integrity. Though 
these commands may save you time, you should 
use the more comprehensive shutdown and halt 
commands as they help ensure that your file systems 
remain intact. 


If you look at /rc.boot and /etc/rc files, you can get 
an idea about the processes that run when a system 
boots. The scripts in these files manage a large part 
of the boot process. 
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user%|sudo shutdown +5 “system going down for maintenance™]. 
Shutdown at Tue May 27 99:14:28 2603. 


*#* System shutdown message from shs@ferro.iocai. *** 


System going down in 5 minutes 
system going down for maintenance 


shutdown; [pid 7@8] 
ferro:~j] user%|ps -aux | grep shut i: 
root 708 @.8 9.1 1432 14@ std S« 9:09AM @:08.02 shutdow: 


[ferro:~] user%|sudo kill 788 
[ferro:~] userx || 


STOP A SHUTDOWN md) Type sudo kill followed 


by the process ID of the 
shutdown process, then 
press Return. 


LI Type sudo shutdown +5 
"system going down for 
maintenance" and press 
Return. A If a prompt appears, type 
your password, and press 


EA If a prompt appears, type Rec: 


your password, and press 


Return. The shutdown aborts. 


<j] Type ps -aux | grep shut 
and press Return. 157 


CREATE A NEW USER 


ou can easily add a new user to your Mac OS X 

system by using the Accounts tool found in System 

Preferences, or from the command line in a Terminal 
window. When you add a new user to your system using 
the Accounts tool, you must fill out a form with information 
describing the new user. You need to assign a username and 
a password. If you want, you can supply a password hint to 
help the user when they cannot remember the password. 
You can also incorporate an image into the logon page. 


When you use the command line method to add new users, 
you can create a file containing the information describing 
the new users, or you can build a script containing a series 


of commands that add the new users to the system. 
Current account information may or may not appear in 
the /etc/passwd file on your system. Mac OS X does not 
use the information in the /etc/passwd file but uses similar 
information stored in a database called NetlInfo. 


You can use the nidump command to list the password 
information that your system uses. Similarly, you can load 
new information into the Netinfo databases using the 
niload command. The niutil command allows you to 
read and write NetInfo data. For example, using the 
niutil command, you can add each portion of a user 
record to the database using a separate command, or 
modify a portion of a user record. 


CREATE A NEW USER 
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cesta 


nobody: *:-2:-2::8:6:Unprivileged User: /dev/null: /dev/null 

root: 2H3/rHp8bxG4E 0:0: :8:0:System Administrator: /var/root: /bin/tcsh 
daemon :*:1:1::8:0:System Services: /var/root : /dev/null 

unknown: *:99;99;:8:@:Unknown User: /dev/null; /dev/null 

ww: *: 78:78: :8:0:World Wide Web Server:/Library/WebServer :/dev/null 
shs:OpagXxxoJzTWI 51:20: :8:6: Sandra Henry-Stocker: /Users/shs:/bin/tcsh 
mysql; *:74:74::0;@:MySQL Server: /dev/null :/dev/null 

sshd: *:75:75::8:0:sshd Privilege separation: /var/empty: /dev/nult 
smmsp:*:25:25: :0:8: Sendmail User:/private/etc/mai Ll: /dev/nuil 

user: CIV@UtGSAL Cac :502:28::0:@:Man T. User: /Users/user: /bin/tcsh : 
eastocker :HX/ObG45KI05Q :5@3:2@::@:@:Eric A, Stocker: /Users/eastocker : /binf 
/tcsh 1 
amaranthe: ouyOR@z jOWr fg :504:20::8:9:Amaranthe Stocker: /Users/amaranthe: /bf 
in/tcsh : 
kbartlett: :5@0:20::@:@:Kynn Bartlett: /Users/kbartlett:/bin/tcsh 

anna: :5@5:20::8:@:Anna Easley Roberts: /Users/anna: /bin/tcsh 

zoe: QOMCzCHng/Fqk:511:20::8:@:Z0e Chloe Doe: /Users/z0e:/bin/tcsh 

postfix: *: 23456: 23456: :0:0:Mail: /tmp: /usr/bin/false 


[ferro:~] user%|nidump passwd . > passwd. txt 
(ferro:~] users’ 


2 Type nidump passwd . > 
passwd.txt and press Return. 


ull Type nidump passwd . and 
press Return. 


A copy of your current 


Hl A copy of your current 
user information appears. 


user information is placed 
into a text file. 


2 
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[vi_passwd. txt] 


Type vi passwd.txt and 


M@ The text editor opens with 
press Return. 


a copy of the current user 
information. 


SS ee 


SYSTEM ADMINISTRATION COMMANDS 


If you add users frequently or manage a 
system remotely, you can build a script to 
reduce typing and make the process more 


Example: 
#!/bin/sh 
# add a user 


read user 
read fname 
read shell 


echo -n “username: " ; 
echo -n “full name: " ; 
echo -n "shell: " ; 
uhome=/Users/Suser 


niutil 
niutil 
niutil 
niutil 


-create . /users/Suser 

-createprop . f/users/Suser 
~createprop . /users/S$user 
-createprop . /users/Suser 


efficient. The script below contains niutil 
commands that prompt for each piece of 


passwd 
uid Suid 
gid $qgid 


information it needs to create a new user, $user. 


niutil 
niutil 
niutil 
niutil 


~createprop 
~createprop 
-createprop 
-createprop 


/users/Suser 
/users/$user 
/users/S$user 
/users/$user 


realname $fullname 
shell $shell 

home $homedir 
_shadow_passwd "" 


mkdir $Suhome 
chmod 755 Suhome 
chown $user $uhome 


echo "password: " 
passwd $user 
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dy : ge 
root: 2H3/rHp8bxG4E :8:@: :@:0:System Adrinistrater: /var/root:/bin/tcsh 
daemon :*:1:1::0:0:System Services :/var/root : /dev/null 
unknown ; *:99:99::@:@:Unknown User:/dev/null: /dev/null 
we: *:70: 78: :0:@:World Wide Web Server: /Library/WebServer : /dev/null 
shs :0p3gXxxoJzTWI:501:20; :0:@:Sandra Henry~Stocker: /Users/shs:/bin/tcsh 
arysql:*:74:74: :0:@:MySQL Server: /dev/null : /dev/null 
sshd:*:75:75::8:@:sshd Privilege separation: /var/empty: /dev/null 
smasp: *:25:25::0:0:Sendmail User:/private/etc/mail: /dev/null 
user: c)V@UtGSAL cac 7502: 20::0:@:Man T. User: /Users/user:/bin/tcsh 
eastocker :HX/ObG45K10SQ : 503: 2: :@:0:Eric A. Stocker: /Users/eustocker: foing 
/tesh : 
omaranthe : ouyOB@z jOWr fg 7504: 20: :@:0:Amaranthe Stocker: /Users/amaranthe: po. 
in/tcsh : 
kbartlett: :500:20::0:0:Kynn Bartlett: /Users/kbartlett:/bin/tcsh 
anna: :505:20::0:0:Anna Easley Roberts: /Users/amna:/bin/tcsh 
zoe: OOMCzCHng/Fak:511:20::9:@:Z0e Chloe Doe: /Users/zoe:/bin/tcsh 
sbob: :512:20:Spange Bob: /Users/sbob: /bin/tcsh || 
postfix: *:23456: 23456: :8:0:Mail: /tmp: /usrybin/false 


EJ Press O, and then 
type sbob: :512:20:Spong 
Bob:/Users/sbob:/bin/tcsh, 
ensuring no other user is 
assigned UID 512. 


TF save your file, and exit vi. 


4 Press Shift + G, and then 
press Return. 
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semsp :*:25;25::@:0:Sendmail User: /privateletc/mail: /dev/null 

user: cJV@UtGSALcac +502: 28: :@:8:Man T. UseP: /Users/user:/bin/tcsh 3, 
amaranthe : ouy08O2 j0Wr fg: 504: 20: :@:B:Amaranthe Stocker: /Users/amoranthe: fo 
in/tcsh 

kbartlett: :$0@:20::0:@:Kynn Bartlett: /Users/kbartlett: /bin/tcsh 

anna: :505:20::0:@:Anna Easley Roberts: /Usprs/anna:/bin/tesh 

zoe: OOMCzCHng/Fqk:511:20: :8:0:Z0e Chloe Dpe: /Users/zoe: /bin/tcsh 

postfix: *: 23456: 23456: :@:@:Mail:/tmp:/usr/bin/false 

sbob: :512:2@: :0:@:Sponge:/Users/sbob:/binytcsh 

(ferro:~] user®% 


&:]) Type nidump passwd . and 
press Return. 


Type sudo niload passwd . 
< passwd.txtPassword: and 


R : 
se: @ Your changes are loaded 
Elita prompt appears, type into NetInfo. 
your password, and press 


Return. Mi The new password 


information appears, 
confirming your changes. 


UNIX FOR MAC 


ENABLE THE ROOT USER ACCOUNT 


you to switch user to root — or to log on as root — 

in addition to exercising root authority using the 
sudo command that allows you to run commands as root if 
you are an administrator. The root account on a Unix system 
is the only account that can perform any action; you should 
use it sparingly as the system is not protected from any 
action that this user takes. While normal users cannot 
overwrite files that do not belong to them, root can 
overwrite any file on the system, regardless of who owns it 
and how important it is to the proper running of the 
system. To use the sudo command, you type sudo followed 
by the command you want to run as root. 


a ou can enable the root user account, which allows 


There are times when logging on as root or switching user 
to root simplifies the work that you have to do, but you 


ENABLE THE ROOT USER ACCOUNT 


View Go Window Help 


Finder File Edit 


| Utilities - ; 


we 


: Computes Hore Favorites Applications Search 


26 tems, 15.93 
Re: | 


avallabie 
~ ps Leer 
instatler 


Display Calibrator 


Keychain Access 


Network Utility ODBC Administrator Privat Center 


4 


Stuffit Expander seers 


ENABLE ROOT USING 


Note: For instructions on locating 
NETINFO MANAGER 


the Netinfo Manager in the Utilities 


ul] Open the NetInfo folder, see page 4. 


Manager application. 


es | | 


Process Viewe: i 


must always be careful when you do so. Use of root 
privilege allows you to modify system configuration files, 
store files in directories that are owned by root, shut down 
or reboot the system, and add or remove user accounts. 


The root account is disabled by default in the root account 
information stored in your NetInfo database. This means 
that you cannot log on as root, nor can you use the su 
command to switch users. You can enable it in one of two 
ways. The first is to use the NetInfo Manager. To do this, you 
need to authenticate yourself by entering your password, 
after which you can initiate the change in the root account 
by selecting an option to enable the root account. The 
second method is to change the root password from the 
command line. 


ry Bisa Management Window Help 


Find 


Enable Root U 


SeseeneesmmRpenTerpciseeeaenIe secign te. 


>  aiases 
tonhy 
groups 


You need an admintstrator’s short name and 
password to make changes for the domain: / 


Name: user 


ae 


@ Click the jock to make changes. 


@ The NetInfo Manager 
window opens. 


@ An administrator name 
and password dialog box 


Click Security © pil 


Authenticate. 


<4 Type your password. 
EY Click OK. 


You must re-authenticate ta-mahe additional 


i. 


Property _ 


trusted_networks 


After you enable the root 
account, you can log on as 
root or switch user to root. 
The su command allows you 
to adopt the identity of 
another user if you know their 
password; if you are root, you 
do not need the password. 
Entering su ~ invokes the 
environment of the new user 
in addition to assuming their 
username. This command 
leaves you positioned in the 
home directory of the user, 
with the path of the user 
being active, and the aliases of 
the user defined. You can use 
the su command to assume 
the identity of any user but, 
without an argument, it 
defaults to root. 


pm Security M 


Password: 


£@) Chick the tock to prevent further changes. 


Click Security ® Enable 
Root User. 


@ An Alert message box 
appears informing you that 
you must re-authenticate to 
make additional changes. 


3 Click OK. 


@ The root user password is 
changed, enabling the 
account. 


74 Type your password at the 


prompt. 


SYSTEM ADMINISTRATION COMMANDS 


Terminal 


ENABLE ROOT ON 
THE COMMAND LINE 


LB In a Terminal window, 
type sudo passwd root and 
press Return. 


{ferro:~] user% su 
Password: 
{ferro:~] # pwd 


/Users/user 


[ferro:~] user$ su - 
Password: 
{ferro:~}] root# pwd 


/private/var/root 
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ferro:~] user& jsudo passwd root & 


Changing password for root. 
New password: ; 
Retype new password:| i 
[ferro:~] users [] 


3 Type the new password 
for root at the prompt. 


=4| Retype the new password 
at the prompt. 


@ The root user password is 


changed, enabling the 


account. 


EXECUTE COMMANDS AS ROOT 


ou can run arbitrary commands as root by using the 

sudo command regardless of whether you decide to 

enable the root account on your Mac OS X system. In 
order to use the sudo command, you must be a user with 
system management privilege. If you have this privilege, you 
can make use of root privilege when you need it by 
inserting the word sudo in front of any command that you 
require root permission to execute. 


You do not need root privilege to work on your own files, 
and you should not use root privilege when you do not 
need it because the system has no protection against the 
actions of this all-powerful user. 


The sudo command uses a configuration file that includes a 
list of the users or user groups allowed to run commands as 
root. While this configuration file permits a precise level of 


control over privileges, the default setup gives privileged 
users the ability to run any command as root. Privileged 
users are given privilege when they first establish their 
accounts. However, this privilege derives from their 
membership in the admin group. 


The sudo command prompts you to enter your password 
every five minutes. This process of re-authenticating the 
user helps to ensure that the user running the command is 
really the privileged user. 


You can use the nidump command to display a list of users 
allowed to use the sudo command. The default sudo setup 
places no restrictions on the commands that privileged 

users can run and is not a mechanism for limiting privilege. 


EXECUTE COMMANDS AS ROOT 
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Lee 
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| | Lferro: screenshots} users [sudo passwd sbob 


[ferro:screenshots} user% || 


ISSUE A COMMAND AS ROOT @ The passwd command 


prompts you to enter the new 


1 
Type sudo passwd password for the other user. 


followed by a space, the 
username of another user, 


<4 Type a new password for 
and then press Return. 


the other user at the prompt. 


74 Type your password at the 
prompt. 


Ea Retype the new password 
at the prompt. 


@ The other user's password 
162 is changed. 


LOOK AT THE SUDOERS FILE 
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# sudoers file. 

# 

# This file MUST be edited with the ‘visuHo”’ command as root. 
# 


# See the sudoers man page for the details on how to write a sudoers file 
# Host alias specification 

# User alias specification 

# Cmnd alias specification 

# Defaults specification 

# User privilege specification 

root  ALL=C(ALL) ALL 


%admin AbLLe(ALL) ALL 
{ferro:screenshots} user% [] 


2 Type /ete/sudoers and 


ul Type cat followed by a press Return. 


space. @ The contents of the 


/etc/sudoers file appear. 


SYSTEM ADMINISTRATION COMMANDS 


The sudo command allows you to give limited root privilege to trusted users. 
For example, you can allow a junior administrator to set up accounts for new 
users or to cancel print jobs. By configuring a limited set of commands in the 
/etc/sudoers file for certain users, a system administrator can delegate certain 


system privileges while not giving out access to the root account. To use 
sudo in this way, you need to create a list of commands that one or more 
users can run as root, and then restrict them to the list of commands. Type 
sudo visudo and add system and usernames to reflect users on your system. 


Example: 
kynn, sandra, eric ferro=/sbin/dump, /sbin/restore 
kynn ferro=/sbin/shutdown 


These lines allow the first group of users to use the dump and restore 
commands and the second to shut down the system. 


File Edit 


 ‘erminal File Edit Scroliback Font Window Help S 


e - 


. ¢ Terminal 


Window Help 


Scroliback Font 


sys: *:3:root 
tty:*:4: root 
operator :*:5:root 
mail:*:6: 
bin:*:7: 

staff: *:28; raot 
guest: *:31: root 
utmp:*:45: 
uucp:*:66: 

dialer :*:68: 
network: *:69: 
wow: ©: 78: 

admin; *:88: root, shs,user 
unknown : *:99; 
mysql: *:74: 
sshd:*:75: 


LIST PRIVILEGED USERS A list of the group file SWITCH USER TO ROOT 
appears, including a listing of 
the members of the admin 


group. 


Bul Type who ami and press 


ul) Type nidump group Return. 


LE Type su - and press 
followed by a space. 


Return. 


I You are now running as 
root. 


¢3 Type . and press Return. 74 Type the password for 


root at the prompt, and press Note: The system remembers your 
Return. original logon. 


<3) Type whoami and press 
Return. 


BACK UP YOUR FILES 


by backing up your files. Maintaining a set of backups 

is always a good idea. Mac OS X cannot prevent a 
user from removing a file or a set of files that they may still 
need. There are, however, quite a few tools that you can use 
to back up your files. 


Y ou can safeguard your work and protect your system 


Some Unix commands such as cp and ditto allow you to 
make copies of files. Many long-time Unix users make a 
habit of copying important files before editing the originals, 
in case they need to restore them and start over again. 


Other Unix commands allow you to create archives of 
important files. This is a great way to save a copy of all the 
files associated with the project in a single file. The tar 
command works well for this purpose. 


BACK UP YOUR FILES 
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{ferro:~] user% ff 


BACK UP A FILE WITH CP 


EJ Type the name of the file 
followed by $$, and then 
press Return. 


iB Type cp followed by a 
space. 

@ A copy of your file is 
created with a process ID 
appended to the end. 


74) Type the name of a file, 
followed by a space. 
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Most Unix systems use the dump command for regular 
system backups, although you may need to dump to a 
remote tape drive to use this command. The dump command 
can back up a complete file system or select only those files 
that have changed since the last backup. This latter method 
of backing up is called an incremental backup. 


While dump is a good Unix command, the Mac OS X 
version can only back up an entire file system, fully or 
incrementally, and only works with Unix file systems (UFS). 
If your Mac OS X installation is an upgrade from Mac OS 9 
or earlier, your file systems may all be HFS+. If this is the 
case, you might consider downloading the hfspax software 
available from www.homepage.mac.com/howardoakley. 
This software works well with data and resource forks and 
provides a command-line interface. 
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project_X 
project_X/,0S_Store 
project_X/12- 16-@2_ping. txt 
project_X/adding_user. txt 
project_xX/adduser 
project_X/after 
project_X/b4 
project_X/backup 
project_X/Chap@7.txt 
project._X/Chape@s .txt 
project_X/Chap1@.txt 


project_X/EnabingRoot 
project_X/enable_access 
project_X/files 
project_X/MacOSxX_top1@. hm1 
project_X/myfile.txt 
project_X/osxguide2_iimq.pdf 


BACK UP FILES WITH TAR 


all Type tar cvi followed by a 
space. 


74 Type " followed by a 
filename. 


E] Type " followed by a 
space. 


Ej) Type the name of a 
directory, and press Return. 


Note: You can also type the name of 
a Set of files, such as *.txt. 


The system adds the 
specified files to the new 
archive, updating you 
on-screen as it works. 


To initiate a restoration from a dump, use the 
restore -iv£ command followed by the name 
of your backup device or dump file. Use cd_ to 
move between directories, followed by the name 
of a file to select it for restoration, and extract 
when you are ready to begin restoring the files. 


On Mac OS X systems, the dump command can 
only back up an entire file system. Because you 
are probably working with a single partition, it 
requires a large-capacity device to create a 
backup. The dump command can write to the 
tape drive on a remote system if you configure 
the remote system to allow this. 


SYSTEM ADMINISTRATION COMMANDS 


You can use the restore command to restore files 
from the backup that you create with the dump 
command. The restore command can restore an 
entire file system, although you usually only need to 
restore a single file or set of files from your backup. 
In this case, you can use the interactive mode of the 
restore command to navigate within the backed- 
up files. You can then select those files that you 
want to restore and initiate their restoration. The 
restored files appear in a subdirectory of the 
directory where you run the restore command. 
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[ferro:~/tmp} user% 
Tas 
figs/Fg8701, 
figs/Fg07@2. 
figs/Fg0703. 
Figs/Fg0704.ti 
figs/Fgd705 , 
figs/Fg0706. 
figs/Fg0707.ti 
figs/Fg07@8. 
figs/Fg0705, 
figs/Fg0710. 
figs/FgQ7i1. 
figs/Fg@7i2. 
figs/Fg@713. 
figs/Fg0714. 
figs/Fg8715.t1 
figs/Fg0716. 
figs/Fg®717. 
figs/Fg0718. 
figs/Fq@719.ti 
figs/Fg0728.ti 
figs/Fg@721. 


RESTORE FILES WITH TAR The files from the TAR file 
are extracted into the current 


LE Type tar ~xvf followed by directory 


a space. 


74 Type the name of a TAR 
file, and press Return. 
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: Date of this level @ dump: Sat May 17 22:45:@3 2003 
: Date of last level @ dump: the epoch 

: Dumping /dev/rdisk2sS to /dev/nmt/@ on hast oxide 
: mapping (Pass 1) [regular files] 

: mapping (Pass II} [directories] 

; estimated 544640 tape blocks on @.32 tape(s). 

; dumping (Pass III} [directories] 

: dumping (Pass IV) [regular files] 

: 24,64% done, finished in @:18 

: 52.61% done, finished in @:11 

: 76.23% done, finished in 0:85 

1 97.52% done, finished in 0:28 

: DUMP: 54464@ tape blocks on 1 volumes(s)} 

: Level @ dump on Sot May 17 22:45:03 2003 

: Closing /dev/rmt/On 

: DUMP IS DONE 


BACK UP FILES WITH DUMP 3 Type the name of a UFS, 


LB Type dump 0uf followed and press Return. 


by a space. A backup of your file 
system is created, a process 


2 . 
‘4 Type the name of a device dhiatiaiaudkekana tile. 


on a remote system such as a 
tape drive, followed by a 
space. 


CHANGE FILE OWNERSHIP 


someone else can modify the contents of the file. The 

chown command reassigns ownership of a file to a 
new user. This command can only be run by root or by a 
privileged user with the sudo command. The syntax of the 
chown command is chown newuser filename, but you 
can also change both the owner and the group associated 
with a file if you specify both at once. To do this, you enter 
the username of the new user and the group name 
separated by a colon. A command like chown 
horace:devt myapp. java, for example, changes the 
owner to horace and the group to devt for the file 
myapp.java. 


Y ou can change ownership of a file so that you or 


Like many commands, you can use chown to work on an 
entire directory if you add an argument to run the 
command recursively. A chown command that starts with 
chown -R is run against all the files in the directory name 
that you supply. 


A similar command is chgrp. The chgrp command 
changes the group associated with a file or set of files. If 
you need to share a set of files with a group of other users, 
you can add these users to the group associated with the 
file or change the group for the file. In general, changing 
the group for the file is easier. 


The chgrp command has a similar syntax to chown. If you 
type chgrp devt myapp. java, then anyone in the 
development team obtains group access to the file. If 
members of the group can write to the file, this allows 
anyone in that group to modify the file. Like chown, chgrp 
can be run recursively with the -R option. 


ie 


4 
[ferro:~} users 


Password: 


mW= Pa = fom 
{ferro:~] userx [] 


CHANGE THE OWNERSHIP 


EI Type the name of a file, 
OF A FILE 


and press Return. 


hl Type sudo chown 


followed by a space. Type Is -I followed by a 


space, then the name of the 


PJ Type the username of a file, and press Return. 


user on your system followed 
by a space. 


i The file now has a new 
owner. 


@ Terminal file Edit Scroilback Font Window Help &. 


CHANGE THE GROUP OF A FILE 


@ Terminal File Edit Scroiiback Font Window Help 


wPwePe-re- 1 shs guest 42414 May 17 21:17 myfile 
[ferro:~] user% [] 


<3} Type the name of a file, 
and press Return. 


AE Type sudo chgrp followed | 3” 
by a space. 4 Type Is -I followed by a 
space, the name of the file, 


EA Type the name of a group and then press Return. 


on your system followed by a 
space. 


BB The file now has a new 
group. 


When you change the group and 
ownership of a file, you do not affect the 
contents of the file in any way. Information 
about a file, referred to as metadata, is 
stored in a separate location from the file 
itself. You affect this metadata when you 
change ownership or the permissions 
associated with a file. Metadata is stored in 
a file system structure known as an inode. 
You see metadata every time you list file 
information using the 1s -1 command. 
You can list files with the numbers of the 
inodes that are associated with these files 
by using the -i option instead. It is 
sometimes useful to know which inodes 
are being used. For example, two files in 
the same file system with the same inode 
refer to the same content. 


(ferro:~] user%|is -1 myotherfile 
-ra-r--r-~ 1 shs guest 84828 jun 1§ 10631 myotherfile 
(ferro:~] user® {] 


CHANGE THE OWNER 
AND GROUP OF A FILE 


LN) Type sudo chown 
followed by a space. 


<4 Type the name of a group 
on your system followed by a 
space, then type the name of 
a file, and press Return. 


SYSTEM ADMINISTRATION COMMANDS 


RESULT: 


139742 AnnaRoof.JPG 
143416 AnnaSky.JPG 
141835 AugSky1.JPG 


140953 NoLaneBridge.JPG 
140093 OldBarn.JPG 
140095 OldBarn2.JPG 
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‘ ee 


[ferro:~] user® |] 


CHANGE THE GROUP OF 


EJ Type th f 
AN ENTIRE DIRECTORY ype the name of a group 


on your system followed by a 


1 Type sudo chgrp followed | Space. 


by a space. EJ Type the name of a 


24 Type the name of a user 
on your system followed by a 
colon (:). 


aa) Type Is -I followed by a 
space, the name of the file, 
and then press Return. 


74 Type -R followed by a 
space. 


i The file now has a new 
owner and group. 


directory, and press Return. 


Mi All the files in the directory 
now have a new owner and 
group. 
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CREATE SYMBOLIC LINKS 


creating symbolic links. A symbolic link is a special 
file that acts as a pointer or shortcut to another file or 
directory at another location in the system. 


Y ou can simplify the navigation of your file system by 


By creating a symbolic link to a directory with a long or 
difficult pathname, you can move to the directory by typing 
cd followed by the name of the link you create. If you want 
to create a shortcut for moving into or listing the contents 
of the directory /Applications/Utilities, you can type the 
command In -s /Applications/Utilities util. The full 
pathname specifies where you want your link to point, 
while the final argument specifies what you want to call 
your link. The -s argument tells the 1n command that you 
want to create a symbolic link. 


After you type this command and press Return, you can 
type commands such as 1s utilsorcd utils. If you 
only specify the file or directory that you want to point to 
when you type the 1n -s command, the link receives the 
same name as the original file. 


If you share a set of files with other users, and those files 
are not stored in your home directories, you can use 
symbolic links to simplify the sharing process and better 
organize the shared files. If you do not include the -s 
argument, you create a hard link instead of a symbolic one. 
A hard link is a special copy of a file, in that it is a reference 
to the original file. Though it looks like a file that is 
completely independent of the original, it is the original file 
with a new file system reference; any changes to the 
original file are reflected in the link. 


CREATE SYMBOLIC LINKS 


| @ Terminal File Edit Scroliback Font Window Help % 


paces Bed 


[ferro:~] user% lin ~s|[/ete/s slog. cont 
L 


[ferro:~] user% 


CREATE A SYMBOLIC LINK 


41 Type In -s followed by a 
space. 


@ A symbolic link is created 
which points to the file. 


rd Type the full pathname of 
a text file, and press Return. 


space. 


new symbolic link, and press 
Return. 
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A long listing of your 
symbolic link appears. 


Type Is -1 followed by 


The | in the first column 
indicates that this file is a 
symbolic link. 


Type the name of your 


SYSTEM ADMINISTRATION COMMANDS 


links offer a particular advantage over copies of 
files, unlike copies, hard links require no 
additional disk space. The contents of the file are 
stored in only one place on the system, WwW 
regardless of how many hard links you create. 


of a file, the contents of those files can easily 
become out of synch. However, if you use a hard 
link, you can both keep a hard link file in your 
home directory, with the assurance that any 
changes that either of you makes are reflected in 
both hard link files. 


167100 /bin/csh 
167100 /bin/tcsh 


You create hard links with the 1n command. For 
example, the command 1n java myapp allows 
you to refer to java as myapp. 


Hard links are similar to symbolic links, except 
that hard links point to the contents of a file, 
while symbolic links point to the name of a file. 
When two files use the same inode, you know 
they are hard links. 
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{ferra:~] user® fess |syslog. conf | 

* err; kern,*; auth. notice gauthpriv, remoteauth.none;mail.crit 
dev/console 

* notice;*, info; authpriv Jremoteauth, ftp.none;kern.debug;mail.crit 
var/log/system. Log 


Lina 
[ferro:~] user% pls -1 myfile myiink 


~rwxr-xr-x 2 shs guest | 233 May 17 21: 
[ferro:~] users {] 


# Send messages normally sent to the console also to the serial port. i 
# To stop messages from being sent out the serial port, comment out this © 
line. & 
#* err; kern.*; auth, notice; authpriv, remoteauth, none;mail.crit 7 ; 
dev/tty.serial } 


# The authpriv log file should be restricted access; these 
# messages shouldn't go to terminals or publically-readable 
# files. : 
oauthpriv. *;remoteauth.crit /var/log/secure.L 


R 
/var/log/1pr.log | 

/var/Log/mail . Log 4 
/var/log/ftp.log -* 
netinfo.err /vor/Log/netinfo. 


Z 


Type less followed by a The contents of the LH Type In followed by a 
space. original file appear, showing space. 
that your symbolic link 


Type the name of your connects to the original file. 74 Type the name of a text 


symbolic link, and press file in your directory followed 
Return. by a space. 


SJ] Type a new filename, and 
press Return. 


You can use hard links to make files easier to 
access or to give them additional names. Hard 


[ferro:~] ls -l /bin/csh 


[ferro:~] ls -] /bin/tcsh 


ns , RESULT: 
If you and another user maintain personal copies 


~rwar-xr-x 2 shs guest | 233 May 17 21:21 


mylin 


Ea Type Is -I followed by a 
space, the names of the two 
files separated by a space, 
and then press Return. 


The files appear identical 
except for their names. 


CHECK DISK USAGE 


ou can use the df and du commands to determine 

how much space is available on your disks and how 

much space is used, respectively. The df command 
tells you how much disk space is allocated, used, and 
available. When you use the df command with a -k 
argument, disk space appears in kilobytes instead of 
512-byte blocks. 


One of the columns that appears in the df output is 
Capacity. This column shows you how much room in that 
file system is already used as a percentage of the overall 
space available. Most Unix system administrators try to 
keep file systems at less than 90 percent of capacity simply 
because they perform better when there is adequate free 
space. 


You can use the du command to determine how much 
space a particular directory uses. This command can help 
you track down files that consume a lot of space in a file 


@ Terminal File Edit Scrofiback font Window Help 


y 
fdev/disk@s5 53545168 20079136 32954932 
devfs 180 180 t) 
fdesc 2 z a 
<vol fs> 1024 1024 ® : 
ts] /Network/Servers 
@ /automount 


automount -fstab [323] 6 6 
automount - ~static [323] 8 ® 


DISPLAY DISK FREE 


The system displays your 
SPACE IN BLOCKS u plays y 


file system usage in blocks. 
mB Type df and press Return. 


SPACE IN KILOBYTES 


system that is running out of space. For example, if you cd 
into a particular directory and use the command du -sk * 
| sort -n, you receive a list of the contents of that 
directory sorted in size order. This is very helpful if you 
want to know where most of the disk space is being 
consumed. 


You can use the df -k command periodically to see how 
much space remains on your disk. When a file system 
approaches full capacity, the responsiveness of the system 
decreases, although any file system that is less than 90 
percent full is not a reason for concern. At the same time, 
any file system that jumps in size by 10 percent in a short 
amount of time may do so again. The rate at which a file 
system is growing suggests how soon you will run out of 
space. 
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/dev/disk@ss 26772584 10039680 16476904 

devfs 98 98 (dev 

fdesc 1 1 dev 

<volfs> 512 512 /.vol i 
automount -fstab [323] a t) /Network/Servers | | 
dutomount ~static (323) a v) /automount ; 


DISPLAY DISK FREE § The system displays your 


file system usage in kilobytes. 
LE Type df -k and press 
Return. 


SYSTEM ADMINISTRATION COMMANDS 


The df command can also report on the creates a generous allocation of inodes. When 
number of inodes allocated and used on your you type the command df -i, the system 

file systems. While this may not be an issue on displays the number of inodes used as iused 
your system, it is possible for a file system to and the number available as i free. Unless 
run out of inodes just as it is possible for a file the ifree value is extremely small, you are 
system to run out of disk space. In either case, unlikely to have any problems. The ratio of 
you cannot create new files until you solve inodes to disk space is usually set so that 

the disk space or the inode issue. When you running out of inodes is nearly impossible. 
first create a file system, the system also 


[ferro:~] df 


Filesystem 512-blocks Used Avail Capacity iused ifree %iused Mounted on 
/dev/disk0s 53545168 17462872 35570296 32% 2246857 4446287 33% / 
devfs 0 100% 100% /dev 
fdesc 0 100% 1% /dev 
<volfs> 0 100% 100% /,vol 


Qe File Edit 
1-7 ee ae 
ferro:~] user%|du -sk *]{} sort -n| 
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‘{ferro:~] user% }duj~sk] *] 


Desktop ) Desktop 
Documents Q i 
Fgl@@1.tiff @ 

Fgl002.tiff : 

Fgl@03. tiff 4 Sg 
Fgl0e4.tiff é 

Libra ry a findme 
Movies 4 addloop 
Music 4 my file 
Pictures 4 myf 116051763 


Public toplog 


dulog 
figs 
fite_l.html 


httpd-2.@.43.tar 
src 


2 


@ 

@ 

32 Sites downloads 
4 addioop Sites 

4 changes instructions. txt 
4 check space lee.Z 

4 copy_file 

4 copy_url ie oa 

4 count _comments figs 

4 count_users Documents 
28 downloads ‘tmp 

4 

5 

& 


DISPLAY DISK USAGE 


DISPLAY DISK USAGE <4] Type * and press Return. 
IN ORDER OF SIZE 


3B z 
IN KILOBYTES ype sort -n and press 


The system displays the Return. 


sizes of your files and 
directories. 


LE Type du followed by a 
space. 


ul Type du -sk * followed by 


a space. The system displays the 


sizes of your files and 

74 Type -sk followed by a PA Type | followed by a directories in order of size. 
yp Y yP y 
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MANAGE THE PRINT QUEUE 


queue and cancel print requests. This command also 
lists print jobs that are waiting in the queue. As the 
printer handles each print request, the job disappears 
from the queue and the next job in line starts printing. The 
cancel command cancels a selected print job, removing it 
from the queue and leaving the remaining jobs to be 
printed. 


Y=: can use the lpg command to examine your print 


You have numerous reasons to examine a print queue and 
to cancel jobs. For example, if you are waiting a long time 
for a printout, you can check the queue to see what other 
jobs are printing or should be printing. If the printer has 
been out of paper for a while, you can view where your 
print job is in the queue, and decide whether to cancel 
the job. 


Some users request a printout of a document several times 
in a row before checking to see if the reason that it does 
not print is because there is no paper. When this happens, 
it is a good idea to cancel all but one of these print jobs. 
Other users may print a document in the wrong format and 
end up printing a pile of paper that they cannot use. 
Canceling these jobs can save you both time and paper. 


To submit a print job from the command line, you can use 
the lpr command followed by the name of the file you 
want to print. Applications, such as Photoshop, also submit 
print jobs and these also appear in your print queue. You 
can view all of the pending print jobs using 1pq, whether 
the print requests are generated by applications or the lpr 
command and regardless of who submitted each print 
request. 
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EXAMINE THE PRINT QUEUE 


Z4| Type the name of a text 
file, and press Return. 


ill Type Ipr followed by a 
space. 


2 


Font Window Help 
pd: 


B _938C is ready and printing 

Rank Owner Job File(s) 

active user 32 file 
erro:~] userk {| 


Total Size 
1024 bytes 


@ The file queues for 
printing. 


I The print queue displays. 


Type Ipq and press 
Return. 
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DESKIET_938C is 
Rank Owner 
ist user 
[ferra:~] user% 
[ferro:~] user® [] 


not ready 
Job File 
¥ Fi 


CANCEL A PRINT JOB 


uy Type Ipq and press 
Return. 


@ The print queue dis 


SYSTEM ADMINISTRATION COMMANDS 


If you need to cancel all of the jobs in a print queue, you can use the cancel 
command with a -s argument. This command option saves you the time of 
canceling jobs individually. 


The Print Center is a useful tool for monitoring and controlling your printer; it 
allows you to: determine the status of a printer; restart the printer; view the 
jobs that are waiting to print; and determine whether the printer is active. If 
the lpg command indicates that your printer is not ready, you can set it back 
to operational status using the Print Center. To do this, double-click the name 
of the printer that the 1pq command tells you is inactive, and activate it again. 
The Print Center is located in the /Applications/Utilities folder. 


DESKJET_930C is ready and printing 
Rank Owner Job File(s) 
active user 3 Chapll1. txt 
ist 4 oldhouse. jpg 


[ferro:~] users’ lpq 
Total Size 
36864 bytes 
user 919552 bytes 
Each job in the queue has a rank, an owner, and a job number. To cancel a 

job in the queue, use the command cancel followed by a space and the job 

number. 


Window Help File Edit 
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[Ipc [status 


printer is on device ‘//dev/null’ speed ~1 
queuing is enabled 
printing is disabled 
no entries 
daemon present 


{s) 
le 


Total Size 
1024 bytes 


CHECK ON THE PRINTER STATUS 


v4 Type cancel followed by a 
space. 


74 Type status and press 
Return. 


LB Type Ipc followed by a 
Ky Type a job number from space. 
one of the print jobs in the 


list, and press Return. 


The status of the printer 


plays. displays. 


@ The print job is cancelled. 
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INSPECT SYSTEM LOGS 


ou can learn a lot about system operations and 

problems by inspecting your system logs for error 

messages and various anomalies. System logs, stored 
in /var/log, record the activities of many system services 
such as e-mail and printing. You will find these files to be 
valuable as they can be an important source of information 
when system problems arise. 


The most important messages about your current logon 
sessions appear in a log file called console.log. You can view 
these messages using the Console tool, available in 
/Applications/Utilities. The scrollable window allows you to 
read the messages that accumulate after you log on. These 
messages include authentication failures and mounting 
problems. 


A system daemon called syslog maintains most system log 
files. Like numerous other daemons, the syslog daemon, 
syslogd, has a configuration file that it reads when it starts 


@ Finder File Edit View Go Window Help 


Back = faonward Home  Favarites psd TE, Search 


te eos 


OPEN THE CONSOLE 74 Double-click your system 
APPLICATION Bick 


i On the desktop, click 
Finder in the Dock. 


7; 


up. This configuration file tells syslogd where to write each 
type of log message. By using the services of syslogd, other 
services do not have to do their own logging. The syslog 
configuration file, /etc/syslogd.conf, provides you with an 
opportunity to change where logs are written or to 
deactivate certain types of logging. To modify the logging 
operations of syslogd, you can modify the configuration file 
for syslogd and instruct the daemon to check the file for 
changes. Do not edit the default /etc/syslogd.conf file 
unless you want to separate particular messages or stop 
collecting them altogether. 


If you keep the Console tool open while you work, you can 
see these messages display as the daemon generates them. 
This is a good troubleshooting technique as it informs you 
of problems immediately and reminds you to check your 
log files. 
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EY Double-click 
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TextEdit 


com 


OroborOSx-v0.8.5 


Roxio Toast Lite 5.2 


@ The Applications folder 
appears in a Finder window. 
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The log file that gathers the most information 

on most Mac OS X systems is system./og. The 
system writes many routine messages to this file, 
and the system./og file is routinely rotated. Older 
system.log files are renamed system.log.0, 
system.log.1, and so on, and are compressed 
with gunzip to save space. At any point, you may 
have a number of these files available to you to 
help you track down a problem. Any log file may 
have thousands of records — far too many for 
you to read the file from top to bottom. Using 
commands like grep and awk to extract some 
of this data can make the job of reviewing log 
data much easier. You might consider writing 
scripts that check for certain types of errors in 
your log files and report the findings to you. 

You can check the /etc/syslog.conf file to see 
where particular types of messages are written. 


Sherlock 


kee: 


System Preferences 


X 


<4 Scroll down until the 
Utilities icon is visible. 


Ey Double-click Utilities. 
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Jun 49 21:27:53 ferro lookupd(273]: DNSAgent : 
for 162.33.160.108 


dun 19 21:27:53 ferro lookupd[273]: ONSAgent: 
for 162.33.160.26 


Jun 19 21:27:53 ferro lookupd[273]: DNSAgent : 
for 162.33.166.143 


Jun 19 21:27:53 ferro lookupd(273]: DWSAgent : 
for 162.33.168.26 


dun 19 21:27:53 ferro lookupd[273]: DNSAgent: 
for 162.33.166.108 


Mi The Utilities folder appears 
in a Finder window. 


Double-click Console. 


dns_send_query_server - send failed / 
Gns_send_query_server - send foiled : 

6 
dns_send_query_server - send failed : 


dns_send_query_server ~ send failed 


The Console application 


opens. 
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COMPRESS LARGE FILES 


compressing it — down to a sixth or less of its 

original size when you use a good compression tool. 
Compression is a good solution for managing your disk 
space while not sacrificing files that you may need later on. 


Y= can greatly reduce the size of a file by 


For most files, gzip is one of the best compression tools 
available. It is both quick and effective, reducing files down 
to a fraction of their original size. It is also available on 
many systems, allowing you to move your compressed files 
to another system, confident that you can unzip them. To 
compress a file, you can type gzip followed by the name of 
the file. The gzip command creates a new file with the 
extension .gz appended to the end of the filename. For 
example, when you compress the /var/log/system.log.0 file, 
the resultant file is called system.log.0.gz. Unlike Windows, 
Unix does not care how many extensions a file has. 


COMPRESS LARGE FILES 


The other command that you can use to compress a file is 
called compress. The compress command compresses a 
file using a different algorithm than gzip. It also uses a 
different file extension. Files compressed with the 
compress command take on the extension .Z. 


The gzip and gunzip tools are members of the GNU tools 
that many Unix systems use whether they are included in 
the distribution or added later. These commands are 
included in the standard distribution of Mac OS X. 


Both the gzip and the compress commands use the 
filenames to determine whether a file is already 
compressed. It is possible to compress a file again after 
renaming it, but the subsequent gain is small, and the 
likelihood of confusion high. 


Terminal File Edit Scroliback font Window Heip 
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rrrerror-T aserats 1] Reed 2. 3. cE Ze 


d-2.@.4 


COMPRESS A FILE WITH GZIP E¥ Type the name of the 
original file followed by .gz 


Lt Type gzip followed by and then press Return. 


a space. 
The listing shows that the 


£4) Type the name of a file, file is compressed. 


and press Return. 


Ey Type Is -I followed by a 
space. 
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UNCOMPRESS A GZIPPED FILE 


Ferminat File Font Window Help -. 


Edit Scroliback 


Ga Type the name of the 
original file. 


us Type gunzip followed by 


a space. The listing shows that the 


PA Type the name of a file is uncompressed. 


gzipped file, and press 
Return. 


a Type Is -I followed by a 
space. 
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Most software that you download from FTP sites is compressed to 
reduce both the storage space requirements on the server and 

the time required to download the file. You can determine the 

type of compression used by looking at the file extensions. Files 
that end in .Z have been compressed with the compress command, 
while those that end in .gz have been compressed with gzip. You 
may also see file endings such as .zip, .tar.Z, and .tgz. 


FILE EXTENSION DESCRIPTION 


BENEFIT 


ZIP Files ending in .zip are ZIP files. | Many systems have zip and unzip commands 


and can both create and extract from these files. 


Files ending in .tar are tape These files are not compressed 


archive or TAR files. 


but contain a number of files that you can 
individually or collectively extract with the tar 
-xf command. 


TARZ/TGZ Files ending in .tar.Z or .tgz To extract the contents of one of these files, you 
are TAR files that have also must first uncompress it. This leaves you with a 
been compressed with the TAR file. You then use the tar -xf command 


compress command. 


erro:~} user% [] 


COMPRESS A FILE Gal Type the name of the 
MTN COMPRESS original file followed by .Z 


il Type compress followed and then press Return. 


by a space. I The listing shows that the 
74 Type the name of a file, file is compressed. 
and press Return. 


=) Type Is -I followed by a 
space. 


to extract the contents. 


press httpd-2.8,43.tar 
{ferro;~] useré 1s -L httpd-2.8,43.tar.Z 
-ra-r--r-- 1 user | staff 8290836 May 11/06:23 httpd-2.0.43.tar.Z 
[is _-t[httpd-2.6.43. tar] 
8088 May 


UNCOMPRESS A EJ Type the name of the 


COMPRESSED FILE __ original file, and press 
a) Type uncompress Return. 
i ia The listing shows that the 
PA Type the name of a file is uncompressed. 
compressed file, and press 
Return. 


J Type Is -I followed by a 
space. 


USING NETINFO 


ou can explore and modify the contents of your 

NetInfo database. NetInfo is a service that replaces 

the simply formatted text files that were once used 
exclusively in Unix to store information about systems, 
users, and so on. The early Unix systems stored all user 
information in the /etc/passwd file, and information about 
the local system and other systems in /etc/hosts. Along with 
some additional files, also stored in /etc, the records in 
these files determined who could log on and what services 
the system could support. 


In the past, new lines were added to the /etc/passwd file 

as new user logons were created. New hosts were added to 
the /etc/hosts file so that the systems could communicate. 
Today, we use network information and lookup services 
such as Netinfo, NIS, and LDAP on many systems to replace 
the simple text files. 


NetInfo is a lookup service or database that contains many 
types of system information. In fact, if you look for your 


ee 
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usage: nidump [-r] [-T timeout] {directory { format} [-t} domain 
known formats: 

alioses 

bootptab 

bootparams 

ethers 

exports 

fstab 

group 

hosts 


networks 


passwd 
printcap 
protocels 
resoly.conf 
rpe 
services 


LIST NETINFO FORMATS The nidump command 


displays a usage statement 
along with a list of the 
formats that it can 

dump for you. 


3 Type nidump and press 
Return. 


account in the /etc/passwd file, you are not likely to find it. 
The system does not use these files; it uses NetInfo. 
Therefore, learning to browse the NetInfo information base 
and make changes is essential for understanding and 
monitoring your system. 


The most important NetInfo commands are nidump, 
niload, and niutil. The nidump command displays the 
Netinfo contents. The command nidump passwd . 
displays the passwd entries that were stored in the 
/etc/passwd file on older Unix systems. 


You can use the niload command to load new contents 
into NetInfo, and the niutil command for various read 
and write processes. NetInfo refers to the types of 
information that it contains as formats. There are also 
nifind, nigrep, and nireport commands. Read about 
these by entering a man command; for example, man 
nigrep. 


@ Terminal File Edit Scroliback Font Window Help & 


nobody: *:~2:-2::8:0:Unprivileged User: /dev/nuli: /dev/null 
root: 2H3/rHp8bxG4E :@:@: :@:@:System Administrator: /var/root : /bin/tcsh 
daemon: *:1:1::0:8: System Services: /var/root : /dev/nult 
unknown: *:99;99: :@:@:Unknown User: /dev/null :/dev/null 
wows *: 70:78; :8:0:Rorld Wide Web Server: /Library/WebServer ; /dev/null 
shs :hDCSkOnNGkurA: S01: 20: :@:9:Sandra Henry~-Stocker: /Users/shs:/bin/tcsh 
mysql: %:74:74::@;O:MySQL Server: /dev/nulL:/dev/null 
sshd:*: 75:75: :@:0:sshd Privilege separation: /var/empty: /dev/null 
smmsp:*:25:25::6:0:Sendmail User: /private/etc/mail : /dev/null 
user: CJVBUtGSAL Cac: 5@2:2@::0:@:Man T. User: “Users/user:/bin/tcsh 
eastocker : HX/ObG45K105Q :503:20::8:@:Eric A. Stocker: /Users/eastocker: /bin/tesh 
amaranthe : ouyOB@zj0Wr fg:504: 20: :8:8:Amaranthe Stocker: /Users/amaranthe: /bin/tc 
sh 
kbartlett; :500; 20: :0:@:Kynn Bartlett: /Users/kbartlett:/bin/tcsh 
anna: :505:20::0:@:Anna Easley Roberts: /Users/anna: /bin/tcsh 
zoe: QOMCzCHng/Fqk:511:20::@:8:Zoe Doe: /Users/zoe:/bin/tcsh 
~j user || 


DUMP INFORMATION 


Kj Type . and press Return. 
FROM NETINFO 
The contents of that format 


LB Type nidump followed by — are displayed. 


a space. 


FJ Type the name of a format 
followed by a space. 


a ————“‘“‘O™OCOCOSOCOOOUUUU.ULUmULUhLULULULlCd 


wersex ca, 


[ferro:~} user% |] 


BACK UP NETINFO 


INFORMATION IN A FILE 


3 
space. 


% Terminal file Edit Scroliback font Window  Heip << [ ¢ Terminal File dit Scroliback font Window Help . 


panes ae el 
[ferro:~} user%|sudo niutil -destroy . /users/zoe 


ul Type nidump followed by 


4 Type the name of a format 
followed by a space. 


Type . followed by a 


SYSTEM ADMINISTRATION COMMANDS 


While the nidump and niload commands are Netinfo uses terminology that is different from that 
relatively straightforward, the niutil command of the system. For example, not only does NetInfo 


has a number of options, each of which is like a maintain formats in place of files, but it also has 
separate command. These options include directories in place of records and properties in 
-create, -destroy, -createprop, place of fields. If you use the niutil command to 
-appendprop, -mergeprop, -insertval, create a new user record, you can use the niutil 
-destroyprop, -destroyval, -renameprop, -create command, which creates a new directory. 
-read, and -list. You can then set the values associated with the full 


name of the user, their Home directory, and so on, 


Although NetInfo works well, you should by using the niutil -createprop command. 


consider making your changes with a carefully 
written and well-tested script, and not attempt 
to enter all of the necessary netutil commands 
manually. Read the man pages for niload, 
nidump, and netutil to learn more about how 
you can use these commands. 


{ferro:~] user%|sudo_niload |passwd |. <jpasswd.txt | 
{ferro:~] user® [| 


[ [> passwd. txt 


G4 Type > followed by a RELOAD NETINFO E} Type the name of the file 
space, a filename, and then ee into which you dumped the 
press Return. El Type sudo niload followed —_ contents of the format, and 


@ The nidump command by a space. pregeeern- 
dumps the contents of that PA Type the name of a format @ The system reloads 
format into your file. followed by a space. the dumped data back 
Al Tine sudo filotil dest into Netlnfo, including the 
Veet Simi! —ueeleay. “ee Type . followed by a account information for zoe. 
/users/zoe and press Return. space, and then < followed 
@ The user zoe is removed by a space. 
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INSTALL DEVELOPER TOOLS 


ou can load a variety of software development tools performance of your system. Do not be alarmed if your 
Y onto your Mac OS X system. The Developer Tools CD system slows down during this part of the installation 

that ships with the OS contains a complete set of process; this is not UNCOMMON. The installation process may 
development tools. This includes a number of standard take longer than you think it should. Be patient and allow it 
programming languages, utilities, and libraries along with to complete. 


software management tools and debuggers. There are 
compilers that allow you to turn your source code into 
programs your system can run from scratch, debuggers — 
special tools that help you to locate errors in your code, 
and tools to help you analyze performance. 


To make your system easier to manage, you should install 
the developer tools on the same disk as your Mac OS X 
installation, if possible. You can load the developer tools 
from the CD in roughly half an hour. If you are operating on 
a local area network, you can make the developer tools 
You can load all of the tools available on the Developer available on one system and install them on other systems 
Tools CD at once, or you can open the Packages folder and over the network. 

select any of six individual packages that you want to install. 


These are BSDSDK, DevDocumentation, DevExamples, The README.html file is a good starting point to help you 


DevPBW0, DevSDK, and DevTools. find the documentation that you need to get started. You 
can keep your developer tools current by periodically 
During the installation of the developer tools, the installer looking for updates at www.apple.com. 


goes through a number of phases, including an optimization 
phase in which the installer attempts to improve the overall 
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EE Insert the Developer Tools E4 Double-click the icon that Ill The Developer Tools &# Double-click the 
CD-ROM into your drive. appears on your desktop window opens. Developer.mpkg icon. 


@ The tools CD icon appears 
on your screen. 


INSTALL UNIX APPLICATIONS 


The developer tools include the gcc 3.1 compiler. This GNU C 
compiler compiles code written in C, C++, Objective-C, and 
Objective-C++. Developers on other Unix systems — Linux, 
Solaris, FreeBSD, and others, use this same compiler 
extensively. In fact, gcc is used to compile Mac OS X. This 
particular version of the compiler has been enhanced to 
compile faster, and produce more efficient executables. 


If you load the entire contents of the Developer Tools CD, you 
will also install Project Builder, Interface Builder, AppleScript 
Studio, New BSD SDK, gdb debugger, Thread Viewer, and 
Sampler along with the associated documentation. Project 
Builder is Apple’s integrated developer environment and 
assists with development tasks from editing and searching 
through building and debugging. 


If you are a seasoned developer, you will appreciate all the 
tools that are packaged in this tool kit. If you are a new 
developer, you will probably appreciate all the documentation 
and sample code that will help you get off to a productive 
start. Many other features of Mac OS X, such as fine-grained 
multithreading, make this operating system an extremely 
versatile development environment. 


% installer File Edit 
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= instalter requires that you type 5 > 3 nl i 


Name: John T. User 


then 


Welcome to the Mac OS X Developer installer 


sake ters sitar er AGH A nb Dk 


“| Wetcome to the Mac OS X Developer Tools Instaliation Program. You { 
| will be guided through the steps necessary to install the Developer Tools. | 
{ 


@ The Authenticate dialog 
box appears. 


Mi The welcome screen EW Click Continue. 
continue with the installation. | appears. 


jz Enter your password to 


CONTINUED » 


INSTALL DEVELOPER TOOLS (CONTINUED) 


fter you have loaded the Developer Tools on your 

system, you may notice that a new directory has been 

added to your system — /Developer. This directory 
contains the sample code and documentation that is 
provided with the software. The subdirectories inside 
/Developer are set so that anyone on the system can read 
their contents. 


In the Applications directory, you can find many useful tools 
to help with your development projects. Among these, you 
find PackageMaker — a tool to help you package your 
software for easy installation. You can also find Interface 
Builder — a graphical interface editor for Cocoa and 
Carbon applications and MallocDebug — to measure an 
application's use of dynamic memory. The Java Browser can 
make it easier to analyze and view your Java code. More 
than 20 tools are available. 


The Documentation directory contains documentation on 
many aspects of development. To get started with the Java 
development documentation, for example, you can open 


INSTALL DEVELOPER TOOLS (CONTINUED) 


install Mac O4 & Developer 


Developer/Documentation/Java/java.html with a browser or 
by double-clicking the file. This page provides links to 
essential information on using Java on Mac OS X, including 
information about the Java 2 API, WebObjects, and so on. 


Before viewing the Java 2 API reference for the first time, 
type sudo /Developer/Documentation/Java/scripts/ 
unjarJavaDocumentation.sh in a Terminal window. This 
command extracts Java API documentation from a Java 
archive file — a jar file — so that you can read it. There is 
also a PDF file entitled Java Development on Mac OS X that 
introduces you to Java development on your Mac OS X 
system, including Basic Java, double-clickable applications, 
and how to use Project Builder. QuickTime for Java provides 
cross-platform APIs to allow you to build multimedia 
components, such as streaming audio and video, for both 
Macintosh and Windows systems. 


@ installer File Edit Window Help 
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Software License Agreement 
® introduction 
@ticense 


Seiect : PLEASE READ THIS SOFTWARE LICENSE AGREEMENT ("LICENSE”) 
| CAREFULLY BEFORE USING THE SOFTWARE AND PRESSING THE “AGREE~ 
: BUTTON THAT 1S DISPLAYED AFTER YOU PRESS THE “CONTINUE” 
| BUTTON. BY PRESSING “AGREE” AND/OR USING THE SOFTWARE, YOU 
i RE AGREEING TO BE BOUND BY THE TERMS OF THIS LICENSE. If YOU 
| OO NOT AGREE TO THE TERMS OF THIS LICENSE, DO NOT USE THE Py 
: SOFTWARE AND GF APPLICABLE} RETURN THIS SOFTWARE TO THE PLACE | 
i WHERE YOU OBTAINED IT FOR A REFUND OR PRESS “DISAGREE”. : 


2 APPLE COMPUTER, INC. 
| SOFTWARE LICENSE AGREEMENT FOR MAC OS X DEVELOPER SOFTWARE 


PL, General, The software, tools, utilities, sample ar example code, 

; decumentatian, fants and other materials accompanying this License, 

i whether an disk, priat ot electron: documentation, in tead only memory, of 
i any other media, (collectively, the “Developer Software’) ate licensed, not 

i sold, to you by Apple Computer, inc. (Apple’! and/or Apple's licensors. The 
i rights granted heretn are limited to Appie’s and/or Apple's ficensors” 

i respective intellectual property rights in the Developer Software and do not 

i include any ather patents or inteifectual property rights. You own the media 

i on which the Developer Software is recorded but Apple and/or Appie’s 

i lxensoris} seta ownership of their respective portions of the Developer 

i Software itself. The terms of this License will gowern any software upgrades 

i provided by Apple thal replace and/ar supplement the original Developer 

i Software. uoless such upgrade i4 accompanied by @ separate dicense in which 
i case the terms pf that ficease wilt govern. 


j £ Pint. & © 
* Print... 3S _Save 


[Read the license 
agreement and click 
Continue. 


i The Software License 
Agreement appears. 


To continue installing the software, you must agree to the terms of 
the software license agreement, 


Click Agree to continue or click Disagree to cance} the installation. 


i 1, General. The software, tools, utilities, sample or example code, 

: documentation, forts and offer materials accompanying this License, 

| whether on disk, print of eectranic documentation, in read ordy memory, 0¢ 
aby other media, (collectively, the “Developer Software”) are licensed, not 

: gold, to you by Apple Computer, tne. Apple") and/or Apple's licensors. The 
: Fights granted herein are [invited to Appie’s and/or Appie’s licensors’ 
respective intellectual property rights in the Developer Software and do not 

: include any other patents or intellectuat property rights. You own the media 
: onwhich the Developer Software is recorded but Apple and/or Apple's 

i hcensons} retain ownership of theit respective portions of the Devefoper 

| Software itself. The terres of this License will govern any software upgrades 
: ptavided by Apple that replace and/or supplement the original Develaper 
Software, uriiess such upgrade is accompanied by a separate ficense in which 
; tase the terend of that ficende wei govern. 


¢ 


€ Print... ] © save: € GoBack ¥ ¢ Continue > 


Click Agree. 


documentation 


release notes. 


choices. 


Select a Destination 


You can begin your browsing of the developer 


by opening 


/Developer/Documentation in your Finder. The 
README file, README.html, provides a gentle 
introduction to the thousands of pages of 
documentation that you find on the system from 
tutorials and conceptual overviews to detailed 


ProjectBuilder allows you to move smoothly 
from looking at your code to viewing 
documentation. By holding down the option 
button and double-clicking on the particular API 
element, the tool takes you swiftly to the proper 
document or provides you with a list of relevant 


@ Introduction 
Seetitense wager: 


; SO! 


Macintash HD 
25.5GB (11.6GB Free} 


| 


Click the disk you want 
the tools installed on, if not 
already selected. 


installing this software requires 22.2MB of disk space. 


se | Select a destination disk to install the Mac OS X Geveloper 


You have selected to install this software on the disk "Macintosh 
| 0." 


EH Click Continue. 


@ introduction i 
PBEiense ure 
}, @Select Destination Click Upgrade to perform a basic installation of this 
_ @installation Type software package. 


rte 


Mi The Easy Install screen 
appears. 
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The developer tools are installed with a large 
collection of pages to help you learn about various 
commands. These pages should have been installed 
during the installation of the developer tools. You 
need to have /usr/share/man on your MANPATH to 
view the pages. You can add this directory to your 
path by typing setenv MANPATH $MANPATH":'/usr/ 
share/man or by adding to the path defined in your 
.tcshrc file. The latter method is a better choice as it 
adds this to your path every time you log on. 


UY Click Install or Upgrade. 


CONTINUED 
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INSTALL DEVELOPER TOOLS (CONTINUED) 


hile many of the tools on the developers CD are 

intended for Java development, there is also a 

large set of tools to help you build applications in 
other languages. The version of gcc that is included is a 
compiler for C, C++, and Objective-C applications. The 


cpp-precomp and cpp tools are preprocessors. The first 
works with C and Objective-C. The latter works with C++. 


The as command is the system assembler. gdb is a 
debugger from the GNU Foundation that is well known in 
the industry. The developer tools provide a debugging guide 
as well as a quick reference to get you started. 


1d is the static link editor. It combines object files into 
binary files such as those that make up applications and 
shared libraries. 


dy1d is the dynamic link editor for Mac OS X. This tool is 
used by applications that load libraries as needed, rather 
than incorporating them as is the case when libraries are 
linked statically. 


libtool creates both dynamic and status libraries and is 
used by gcc as needed. 


The developer tools also provide CVS, a tool for 
maintaining source code that also comes from the GNU 
Foundation. CVS allows you to maintain multiple versions 
of an application and to create any particular version as 
needed. CVS also allows multiple developers to work on 
the same code without the danger of overwriting each 
other's changes. Code is checked in and checked out so 
that only one individual can change a module at a time. You 
can determine differences between multiple versions of the 
same code and merge code as needed to facilitate 
incorporating changes from more than one individual. 
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@ installer File Edit Window Het 

om det ce co Hall Mac 8 X Developer 
install Software 

@ Introduction i 

@License 

® Select Destination 

® installation Type 

@instailing 


M The system prepares to 
load the new software. 


Edit Window Help 
oC caer 


instail Software 
piiradscen remem mmntmtemermmaneatin 
‘@license 

@Select Destinatisn 
‘Binstailation Type 
@instatling: 

Tee ile. | 
‘Processing Mac OS X Developer 


41 Running Installer Script 
i Time Remaining: fess than a minute 


The system continues 


loading the new software. 
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The release notes provided with the developer tools help You can find two of the Aqua dots, 


you to understand what has changed in a tool since the last DotBlue.tif and DotGray.tif, in the 
release. If you are new to development on Mac OS X, the Developers directory. These TIFF 
release notes may not mean a lot to you today, but you may images look like the dots in the 
find them important after you have spent considerable time upper-left hand corner of your 
developing software and are ready to upgrade to a newer Terminal window. 


release of the developer tools. In this case, reading the release 
notes is a great idea as it tells you what to watch out for as you 
begin to work with the newer software. 


Sample Applescript programs are 
available to help with your 
scripting efforts. 


For an unusual introduction to Java programming, double-click 
/Developer/Examples/Java/Sound/Sound. After clicking Start, 
you can read the README.txt file and begin to learn how this 
sample application was created. The application loops, so you 
may want to hit the Stop button after several times. 
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ou can download software in one of two forms: as 

precompiled binaries that you can run after a quick 

installation process, or as source code that you must 
compile before you can run it. The easiest way to obtain 
new tools for your Mac OS X system is to find precompiled 
binaries. While many sources of precompiled binaries exist 
on the Web, you can only use those that are built 
specifically to run on Mac OS X. 


The advantages of starting with source code are first, that 
you can study the source code and determine exactly how 
a tool works, and second, that you can modify the code for 
your own purposes. 


As you might expect, one of the best sources of 
precompiled tools for Mac OS X is Apple Computer. In fact, 
to facilitate your access to their software tools, Apple has 
included the Get Mac OS X Software option in the Apple 
drop-down menu on your desktop, which takes your 
browser to their comprehensive download site. 


When you download a software tool from the Apple site, 
the Download Manager appears, allowing you to monitor 
the progress of your downloads. At this point, you can close 
your browser window. The software continues 
downloading, although you must remember not to shut 
down your network connection if you are on a dial-up line. 


There are several sites that provide Mac OS X precompiled 
binaries. For example, you can obtain a precompiled binary 
for Fink, a sophisticated software package manager for Mac 
OS X, from www.fink.sourceforge.net. Other useful tools 
include Mozilla from www.mozilla.org, PHP from 
www.entropy.ch/software/macosx/php, and XFree86 from 
www.apple.com/downloads. OpenOffice, an office suite 
that rivals Microsoft Office, may be officially released by the 
time you read these words. 
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There are literally thousands of programs that you can 
download and install to increase the usefulness and versatility 
of your Mac OS X system; some of these programs may prove 
to be essential add-ons to your system, while you may install 
others simply because they are interesting or fun. The most 
beneficial programs are those that either complement the tools 
that you already have, or do a much better job than the tools 


delivered with the OS. 


For example, Mac OS X does not include a spell checker. If you 
intend to do a lot of writing on your Mac system, installing 
ispell provides you with a versatile spell-checking system. 
Another tool, aspell, purports to be a more intelligent spell 
checker, but requires some additional configuration. 


Programs that need to generate character-based displays in a 
terminal-independent manner require a copy of libtermcap, 
another program that is not included in the standard Mac OS X 
installation. You can find libtermcap at www.gnu.org. 
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USING OPEN SOURCE SOFTWARE 


ou can download, install, and use open source 

software to great advantage. Open source software is 

free, and is developed and tested by some of the 
most dedicated people in the industry. The intention of 
open source licensing is to encourage collaboration and 
innovation while shifting the focus of control from large 
companies to end-users. 


The Open Source movement is dedicated to quality and fair 
practice. The basic idea behind open source is that, with the 
potential to have hundreds of people improving and testing 
code, the software development cycle is shortened and the 
quality of the software improves. In addition, no individual 
or company can leverage that development toward goals 
that are against the interests of the overall population of 
users. 


Now roughly twenty years old, the Open Source movement 
is finally achieving a presence in the commercial world. As a 
result, companies like Red Hat can achieve financial success 


USING OPEN SOURCE SOFTWARE 


even though they are selling software that is essentially free. 
Commercial success and open source software are not 
incompatible with each other. In fact, Mac OS X is itself 
built on an open source foundation, a core operating 
system known as Darwin. 


Although the development of Linux has been very 
important to the Open Source movement, open source 
development has also brought us tools that are critical to 
the Internet such as BIND, sendmail, and Apache. 


A sizable portion of open source software falls under the 
GNU public licensing (GPL) agreement that states that any 
software incorporating GPL-based software must itself be 
licensed as GPL software. Not all open source, however, falls 
under this licensing agreement, so you need to know how 
source code is licensed to know how you can use it. While 
open source code is available for anyone to use, the original 
developers may retain some intellectual property rights. 
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Version 2, June 1991 


Copyxight (CC) 1989, 15991 Free Software Foundation, ine. 
59 Temple Place ~ Suite 330, Boston, MA @2221~i307, USA 


Everyone is permitted to copy and distribote verbatim copies 
of this License document, but changing it is not allowed. 


Preamble 


The licenses for most software are designed to take away your freedom to share and change 
it. By contrast, the GNU General Public License is intended to guarantee your freedom to 
share and change free software--to make sure the software is free for ail its users. This 
General Public License applies to most of the Free Software Foundation’s software and to 
any other program whose authors commit to using it. (Some other Free Software 


™ Your browser displays the 
content of the license 
agreement. 


GNU General Public License. 
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FIND OPEN SOURCE SOFTWARE 


ou can find plenty of open source software on the 

Web and even participate in open source 

development if it interests you. The best sites for 
open source software are those that are dedicated only to 
open source. These sites include www.freshmeat.org and 
www.sourceforge.net. You can also find useful links and a 
lot of additional information about open source software by 
visiting www.opensource.org. 


You can also look for source code on the original 
development sites of software applications. For example, 
you can go to www.apache.org to download the latest or 
earlier versions of the Apache server. You can get sendmail 
from www.sendmail.com, and you can get GNU tools from 
www.gnu.org. 


If you intend to use open source software for your business 
or projects, the issue of open source certification can 
become very important to you. Open source certification, 
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Sections 
Fink Downloads 
There are many ways to install or upgrade Fink. For new 


users, the quick start instructions below are recommended. 
Otherwise, check out the overview and the upgrade matrix. 


Quick Start 


New to Fink? These quick start instructions are here to get 
you up to speed with the binary release. 


» Binary Release 
>» Source Release 


1 Type http://fink. 
sourceforge.net/download/ 
index.php into a browser. 


The Web page for 
downloading Fink appears. 


performed by Open Source Initiative (OSI), assures you that 
the source code that you are using meets all the 
requirements that qualify it as open source. 


The process of compiling an application from source code 
can range from straightforward to extremely difficult. 
Fortunately, most popular tools have the development bugs 
removed from them a long time before you obtain a copy 
of the source code. These include bugs in the compilation 
process as well as bugs in the code. If you are wary of code 
with bugs, you should avoid any code that is described as 
Beta. Beta is a word for code that has not been fully tested. 


A useful tool that you can download first is Fink. Fink is an 
open source tool for managing software installation and can 
save you a tremendous amount of time in finding, 
downloading, and installing other software. 
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New to Fink? These quick start instructions are here to get 
you up to speed with the binary release. 


“Ss, saying | ID] 


. Download the installer disk image: 
Fink 0.5.1 Binary installer - 12.5 MB 


. Double-click “Fink-0.5.1-Installer.dmg® to mount the 
disk image, then double-click the “Fink 0.5.1 
Instatler. pkg” package inside. Follow the instructions 
on screen. 


3. Open a new Terminal.app window and type “pico 
-cshre”. A text editor will pop up. Enter this line: 


4 Scroll down the page to 
the link for downloading 
Fink. 


INSTALL APPLICATION PACKAGES 


quite easily. This is because a package is a specially 

formatted application file that is designed for easy 
installation. To let you know that a file is prepared for easy 
installation on your system, the Finder uses an icon that 
looks like an opened parcel. 


Y:« can install an application package on Mac OS X 


To install an application package, you can simply double-click 
the icon for the package in the Finder. This initiates a process 
that walks you through each step in the installation. You are 
asked to enter your password to authenticate yourself as a 
privileged user, to accept the license agreement, and to select 
the disk for the installation. You can monitor the progress of 
the installation by watching the progress bar. When the 
installation is complete, a message appears informing you that 
the installation was successful. You install all software 
packages in this manner. 
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Mac OS X also includes an install command, which you 
can use to move binary files into a chosen location from 
where you want to run them. You can specifically avoid 
overwriting earlier versions of the software if you use a —b 
option with the install command. With a -o option, you 
can specify who owns the application when it moves into 
the target directory. Similarly, a -g option allows you to 
specify the group. You can use a -d option to create missing 
directories. With a -m option, you can override the default 
mode of the file, restricting access as needed. 


While downloading and installing software is relatively easy, 
managing it can be much more challenging. Mac OS X does 
not place restrictions on where you install software, so you 
should maintain and enforce a convention to prevent your 
system from becoming disorganized. 
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When you install software in many different locations on your hard 
drive, it can become difficult to keep track of both where you have 
installed your software and what software you have installed. This 
situation is exacerbated when you frequently download new tools 
and utilities. 


While you can manually organize your software, you have another 
option for making the software easier to find and use: You can 


update your search path to include all directories into which you 
install software. 


You can update your search path by editing your shell configuration 
file. If you are using the default shell in Mac OS X, tcsh, your shell 
configuration file is defined in the .tcshrc file in the root of your 
Home directory. The system reads this file every time you log on, as 
well as every time you open a new shell or a new Terminal window. 


To update your path in tcsh, edit your .tcshrc file by adding the line, 
setenv PATH $PATH":"/usr/local/bin:/sw/bin", where 
the specified paths match the locations of your new software. Each 
system user needs to make this change in order to find software 
without knowing the software locations. 
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INSTALL TAR ARCHIVES 


ou Can install software from a tape archive, or TAR 

file, by using the tar command with a -x argument. 

The -x argument instructs the command to extract 
from a specified file. You also use the tar command to 
create these archives, for example, in preparing applications 
for distribution. Many Unix users employ the tar command 
to prepare archives of important personal files. You must 
add a -f argument, making the command tar -xf, to 
indicate that you are including the TAR file in the command, 
and a -v argument, making the command tar -xvf, if you 
want to list the files as you extract them. 


To ensure that the TAR file is intact, it is always a good idea 
to examine the contents of the TAR file before you extract 
from it. If you downloaded a TAR file without using binary 
mode, you may end up with a file that is corrupt. Checking 
the contents also tells you where the software installs when 
you extract it. Most TAR files install in the directory that you 
are in when you issue the tar command. 
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You can use the tar -tvf command to examine the 
contents of a TAR file. For example, to extract from a file 
called drawfigs.tar, you can type tar -tvf drawfigs.tar. If the 
filenames that appear start with a /, the tar command 
attempts to extract the file with the path shown, starting at 
/, Otherwise, TAR extracts the commands into your current 
directory. 


The command for extracting files from an archive named 
drawfigs.tar is tar -xvf drawfigs.tar. The -v 
argument of the tar command stands for verbose. When 
you use this option, the tar command displays each 
filename as it extracts the file. 
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file, and press Return. 
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§ Ina Terminal window, 
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drawfigs.tar 


EXTRACT THE CONTENTS 


Kz Type the name of a TAR 
OF ATAR FILE 


file, and press Return. 


The contents of the TAR 
file extract into the current 
directory. 


In a Terminal window, 
type tar followed by a space. 


r4| Type xvf followed by a 
space. 


INSTALL UNIX APPLICATIONS 


You can use the tar command to extract a single file or directory 
from an archive instead of the entire contents. For example, you 
may want to first read the license agreement or README file before 
proceeding to extract the remaining contents from the archive. 


To extract a single file from a TAR file, add the name of that file to 
the end of the tar command. The command tar -xvf 
drawfigs.tar README extracts only the README file. If you are 
extracting a file from a directory inside the TAR file, be careful to 
type the directory name and filename exactly as they appear in the 
file listing produced by the tar -tvf£ command. For example, if 
the file you want to extract appears as tmpls/template1.tmpl, type 
the command tar xvf drawfigs.tar tmpls/template1 .tmpl. 


lf you want to change some part of the pathname for the extracted 
files while you are extracting them, you can use the -s option. For 
example, if want to change the tmpls directory to orig_tmpls 
during the extraction, you can type tar -s /tmpls/orig_tmpls/ -xvf 
drawfigs.tar. 
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EXTRACT FROM A V4 Type the name of a 
COMPRESSED TAR FILE 


EY Type the name of a 
GUNZIPPED TAR FILE gunzipped TAR file, and 


compressed TAR file, and 


In a Terminal window, press Return. In a Terminal window, press Return. 
type gunzip followed by a The TAR file is type uncompress followed by The TAR file is 
space. uncompressed. apace. uncompressed. 


COMPILE A PROGRAM WITH MAKE 


utility called make, a tool favored by many users of 

open source software. make is not itself a compiler, 
but a tool that manages compilation. With the Mac OS X 
system, make calls gcc, the GNU C compiler, to compile the 
source code. 


Y ou can compile software from source code with a 


While the process of compiling your own applications might 
seem tedious at first, some developments have arisen that 
have made source code compiling much more efficient. For 
one, the process of going from source code to executable 
has become significantly standardized; if you can remember 
this sequence of steps — configure, make, make install, and 
make clean — you can build and install most software that 
you find. For another, you can often avoid the manual 
process of compiling by using a tool such as Fink. 


One reason why make is efficient is because it does not 
recompile a program when the existing program is newer 


COMPILE A PROGRAM WITH MAKE 


than the source code; after all, this indicates that no 
changes have been made to the code since it was last 
compiled. Large applications containing many source files 
recompile much faster than they first compiled because 
only the updated source files are recompiled. You can also 
run make without a Makefile to compile a program with a 
single source file. 


Source code prepared specifically for Mac OS X may 
already include a Makefile. Generic source code requires an 
additional step that evaluates the configuration of your 
system and creates an appropriate Makefile. 


The make instal1 step uses instructions in the Makefile to 
install the application into the directory from which you 
want it to run. The make clean step removes object files, 
which are intermediate files in the compilation of a 
complex application. 
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Return. 
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! 4 Press the spacebar four 
create a file named greetme.c. 


times, type printf("Hello, 
there!\n"); and then press 
Return. 


@ The blank editor screen 
appears. 


F4 Type #include <stdio.h> 
and press Return twice. 
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greetme.c: 5 Lines, 62 characters. 


erro:~] user%|make greetme 


cc greetme.c _-o0 greetme 


[ferro:~] userk 
3~] 


GI save your file, and exit A] Type chmod a+x greetme 
the editor. and press Return. 


@ Your simple C program is 
saved in your directory. 


Type ./greetme and press 
Return. 


The make utility compiles 
your program, and your 
program runs. 


#4 Type make greetme and 
press Return. 
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When you compile Apache from the compressed TAR file that you 
download from www.apache.org, there are several steps you must 
follow. First, you must uncompress the file, and extract the 
contents. You must then run the configure command to prepare 
your Makefile, execute the make command to read the Makefile, 
and call gcc to compile each piece of code and create your 
executables. After this, you run make install to place the new 
binaries and associated configuration files in the directories from 
which you want to run them, and then run make clean to remove 
intermediate files. While that process involves a number of steps, 
these steps become second nature after you build several 
applications this way. 


It is always a good idea to read the included README or INSTALL 
files before you begin the compilation process. These files often 
contain instructions that make building the application easier. For 
example, you may run through all the steps of the building process 
for Apache without realizing that adding a prefix specification such 


as —prefix=/sw/apache to your configure command tells 
Apache to install as /sw/apache/httpd and to look for configuration 
files in /sw/apache/conf. 
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Type make greetme and The make process tells you Type touch greetme.c to The make process 
press Return. there is nothing to be done give your source filea newer — compiles your code again. 
because the source file has timestamp than the compiled a tas . 
not changed. file. The make utility compiles 


your software. 
Type make greetme and 
press Return. 


COMPILE APACHE 


ou can compile and install a new version of Apache 

from source code. New versions are available from 

time to time from www.apache.org. Installing a new 
version may give you additional features, better security, or 
improved performance. 


You compile Apache with the standard set of steps for 
compiling open source software. You generally start with a 
gzipped TAR file freshly downloaded from apache.org. You 
then need to unzip that file with gunzip, and untar the 
resulting file with tar xv£. After your untar operation is 
complete, you have a directory containing all of the files 
needed for configuring and compiling the new version of 
Apache. 


After moving into the new Apache source directory with the 
cd command, you run the configure script that is included 
with the distribution. This step takes several minutes to 


iy 3.tar.gz 
Feta 2- tar xf httpd-2.0.43.tar 
(ferro: cd httpd-2.8.43 


[ferro:~/httpd-2.8.43} user% || 


rH Type tar xf followed by 
the name of your Apache 
TAR file, for example httpd- 
2.0.43.tar, and press Return. 


ull Type gunzip followed by 
the name of your downloaded 
Apache source file, for 
example httpd-2.0.43.tar.gz, 


and press Return. EJ Type cd followed by the 


name of your new source 
directory, for example httpd- 
2.0.43, and press Return. 


@ Your downloaded file is 
unzipped. 


os 


checking for APR.. 


complete. During this stage of preparing for compilation, 
information about your system is being collected and 
analyzed and a Makefile is being prepared that guides the 
compilation process on your Mac OS X system. Keep in 
mind that the Apache distribution was built so that it would 
compile on many different types of systems. Therefore, this 
configuration step is critical to the compilation on any 
particular operating system. 


After the configuration operation is complete, you can 
begin the actual compilation using the make command. The 
make command starts by reading the Makefile that the 
configuration process created and using it to drive the 
compilation process. Unlike the use of make with a simple 
C source code file, this make process compiles many 
different programs and builds a small number of programs, 
in particular the httpd process that represents the Web 
server you have just built. 


File Edit Scroitback Font Window Help 


i~7http users |. 
checking for chosen layout... Apache 

checking for working mkdir -p... yes 

checking build system type... powerpc-apple-darwin6.3 
checking host system type... powerpc-apple~-darwin6.3 
checking target system type... powerpc-apple-darwin6.3 


Configuring Apache Portable Runtime library ... 


. reconfig 


configuring package in srclib/apr now 


checking build system type... powerpc-apple-darwin6.3 
checking host system type... powerpc-apple-darwin6.3 
checking target system type... powerpc-apple-darwin6. 3 
Configuring APR Library 

Platform: powerpc-apple-darwiné. 3 

checking for working mkdir ~p,.. yes 

APR Version: 9.9.2 

checking for chosen Layout... apr 

checking for gcc... gcc 

checking for C compiler default output... a.out 
checking whether the C compiler works... yes 


@ Your Apache Makefile is 
created. 


Type ./configure --prefix= 
followed by the name of the 
directory in which you want 
your new Apache server 
installed, for example /sw, 
and press Return. 


/sw/apache/bin/apachectl start. 
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| (ferro:~/httpd-2.0.43] user%| make] 

Making all in srclib 

Making all in apr 

Making all in strings 

‘bin/sh /Users/user/httpd-2.0.43/srclib/apr/libtool --silent --mode=compif 
le gcc -g -02 -DHAVE_CONFIG_H -DDARWIN -DSIGPROCMASK_SETS_THREAD_MASK -F 
no-cpp-precomp ~-I../include -I../include/arch/unix -c apricpystrn.c && 
touch apr_cpystrn.lo 
‘bin/sh /Users/user/httpd-2.@.43/srclib/apr/libtool --silent --mode=compif: 
le gcc -g -O02 -DHAVE_CONFIG_H ~DDARWIN -DSIGPROCMASK_SETS_THREAD_MASK -f 
no-cpp-precomp ~-I../include -I../include/arch/unix -c apr_snprintf.c & 

& touch opr_snprintf.lo : 

/bin/sh /Users/user/httpd~2.0.43/srclib/apr/Libteal --silent --mode=compif 

le gcc -g -Q2 -DHAVE_CONFIG_H -DDARWIN -DSIGPROCMASK_SETS_THREAD_MASK -§ 
no-cpp-precomp <-I../include ~I../include/arch/unix -c apr_strnatcmp.c 

B& touch apr_strnatcmp.1o 7 

/bin/sh /Users/user/httpd-2.0.43/srelib/apr/libtedl --silent --mode=compi | 

le gcc -g ~-G2 ~-DHAVE_CONFIG_H -DDARWIN -DSIGPROCMASK_SETS_THREAD_MASK -§ 

no-cpp-precomp -I../include -1I../include/arch/unix -c apr_strings.c al 
touch apr.strings.lo 

/bin/sh /Users/user/httpd-2.@.43/srclib/apr/libtoal --silent ren || 

~DHAVE_CONFIG_H -DDARWIN -DSIGPROCMASK_SETS_THREAD_MASK -f 


le gcc -g -02 


Type make and press 
Return. 


Compilation begins. 


After compiling and installing Apache, you have to start the 
server. Along with the files that you just installed is a script 
named apachectil. This script starts, restarts, and stops the 

Apache server. If you installed Apache in /sw/apache, through 
the -prefix=/sw configure option, you can find apachectl in 
/sw/apache/bin/apachectl. To start Apache, you then type 


To learn about the many different options that you can use to build a 
customized Apache server, use the command ./configure -help. 


Terminal 


INSTALL UNIX APPLICATIONS 


The configuration and installation process described on these 
pages is probably the most standard process for installing Apache. 
Without the -prefix argument provided with the configure 
command, Apache compiles to run from the default directory. The 
remainder of the process as described uses only default values. 


Fite Si 


Making install in srclib 


Making all in 
Making all in 
Making all in 
Making all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 
all in 


strings 

passwd 

tables 
File_io/unix 
network_io/unix 
threadproc/unix 
misc/unix 
locks/unix 
time/uni x 
mmap/unix 
shmem/uni x 
user/unix 
memory/unix 
atomic/unix 
poll/unix 
support /unix 
ee ee 


Type make install and 
press Return. 


Seroliback Font 


While your new Apache server is 
ready to run, it uses the default 
DocumentRoot — the directory 
in which your Web pages will 
install — and serves only the set 
of pages that the installation 
process installs. Refer to Chapter 
14 for information on configuring 
your Apache server and 
populating your new Web site. 


Window Help 


/Users/user/httpd-2,0.43/srclib/apr/build/ a 
oe 


Your new Apache server 
will be installed in the 
directory you specified. 


MANAGE SOFTWARE 


INSTALLATION WITH FINK 


ou can manage the installation of software on your 

system using a software package management utility 

known as Fink. Fink is a versatile tool that allows you 
to download, extract, configure, compile, install, update, 
and remove software to and from your system, often with 
no more input from you than a single command. Fink works 
with software that is configured as a package. A package is 
a special format that contains binary files along with source 
code and patches that you may need to facilitate installation 
and subsequent management of the installed software. 


Fink maintains a database that allows it to locate software 
packages. It downloads the packages using curl and then 
proceeds to install your new software while giving you 
progress updates on-screen. 


Fink is intuitive to software dependencies, and so does not 
install a software package if you have not installed 
prerequisite software. It also does not remove software if 
other packages on your system require it. 


MANAGE SOFTWARE INSTALLATION WITH FINK 


Terminal File Edit Scroflback Font Window Help 


{ferra:screenshots] userx 
Reading package info... 
read in 5 seconds. 


aatib Ascii art library 

aalib-bin Ascii art library 

aalib-shlibs Ascit art library 

abiword Open-source word processor 

abs ¢ Opensource spreadsheet 

afni ; Tools for analyzing FMRI data 

align .@, Text filter that vertically aligns columns 


amaze F Text-based 3D maze game 
amor .8, KDE ~ themeable animated window toy 


Periodic command scheduler 

analog Program ta measure usage on your web server | 
app-defaults Creates an app defaults directory for fink 
apt aoe Advanced front-end for dpkg 

apt-dev Advanced front-end for dpkg 

apt-shlibs Advanced front-end for dpkg 

aquaterm ee Displays vector graphics in Aqua. 

arb Phylogeny and sequence data management pa... 
ark 8. KDE - archive utility j 
arts Le KDE ~ analog realtime synthesizer 

arts-dev - KDE - static libraries and headers for aRts |' 


anacron 


Ld Type fink followed by a 
space. 


Fink displays a list of 
packages. 


Z4 Type list and press Return. 


Fink is not included in Mac OS X, but you can download it 
from www.sourceforge.net. You can visit www.fink. 
sourceforge.net/download to find links and instructions on 
how to obtain a copy. 


Fink is a port of a tool called the Advanced Package Tool or 
APT from Debian. Fink allows you to install a package from 
source code or from binary files, depending on what is 
available. Binary package files come in a format known as 
dpkg and have a .deb extension. 


After you install Fink on your system, it is easy to use. The 
command fink list displays a list of available software 
packages. Those that are installed on your system appear 
with a lowercase i in the leftmost column. To install an 
application, you can use the fink install command 
followed by the name of the package you want to install. 


Terminal file Edit Scroliback Font Window Help 


{ferro:~/project_X} user® 
sudo /sw/bin/fink install ispelt 
Reading package info... 


pkg ispell version ### 
pkg ispell version 3.2.@6-3 
The following package will be installed or 
ispell 
% Total % Received *% Xferd Average Speed Time Curr. 
Dload Uptopd Total Current Left Speed | 


2 567k 2 16066 @ 1744 0:05:32 0:08:09 %:05;23 2308 


EZ Type the name of a 
package, and press Return. 


@ Fink downloads the 
package you select. 


Type fink followed by a 
space. 


Type install followed by a 
space. 


INSTALL UNIX APPLICATIONS 


To operate well, Fink needs You can also use dselect to install software. This tool comes from the 

to work with the most Debian Linux community and provides a text-based interface. The 
recent data possible. If you dselect tool guides you through the process of choosing the access 
install Fink and fail to update | method you want to use, updating the list of available packages, 

the inventory of available requesting the packages you want to install, configuring packages which 
software, your installation of | are not yet configured, and removing unwanted software. The tool 

Fink gradually becomes out opens with the following menu. 

of date and unable to 


recognize new releases of Example: 
packages. Debian ‘dselect' package handling frontend. 


To update the list and {A]ccess Choose the access method to use, 
descriptions of packages that (Ulpdate 


Fink uses to find and install , Weieieee 
software, use the command [ianseea 
fink selfupdate. To 
update all of the packages 
that you have already 
installed, type fink update-all. 


Update list of available packages, if possible. 
Request which packages you want on your system. 
Install and upgrade wanted packages. 

[C]lonfig Configure any packages that are unconfigured. 
[R] emove Remove unwanted software. 

[Q]uit Quit dselect. 
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[ferro:screenshots] user% fink list . ; fink|list |} grep ispell| 
Reading package info... i aspelt @,50.2-1 Spell checker more intelligent than ispell 
Information about 769 packages read in S seconds. : i ispell 3.2.@6-3 Interactive spell-checker 
: ispell-french 1.@-1 French ispell dictionary 
aatib 1.4rc5-2 Ascii art library i ispell-german 2@@11124-1 German ispell dictionaries 
aalib~bin Ascii art library j ispell-italian 2081-2 Italian ispell dictionar 
aalib-shlibs é Ascii art Library 4 erro: screenshots 
abiword .@. Open-source word pracessor q 
abs Opensource spreadsheet 
ofni Tools for analyzing FMRI data 
align Text filter that vertically aligns columns 
amaze Text-based 3D maze game 
amor KDE ~ themeable animated window toy 
anacron Periodic commond scheduler 
analog Program ta measure usage on your web server 
app-~defaults Creates an app defaults directory for fink 
Advanced front-end for dpkg 
Advanced front-end for dpkg 
Advanced front-end far dpkg 
Displays vector graphits in Aqua. 
Phylogeny and sequence data management pa... 
KDE - archive utility i 
KDE - analog realtime synthesizer 
KDE - static libraries and headers for ats 


Winns nuwesoun 
Ss 
RrBs 
Pw = 
N 
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‘ 
a 


www ee NNN 


Pel 
S. 4 oe 
eexret 


orts-dev 


Fink continues with the Type fink followed by a =| Type | grep followed by 
configuration, compilation, space. the name of the package you 
and installation of your new just installed, and press 


Type list followed by a 
space. 


software. Return. 


Fink confirms that the 
installation is successful. 


MANAGE FINK WITH FINKCOMMANDER 


ou can download software using FinkCommander, a 

graphical interface that works with Fink. 

FinkCommander provides a GUI front end to the Fink 
software package management tool. Using this front end, 
you can select the software that you want to install and 
initiate the installation by picking the software from a list of 
available packages. Fink provides a variety of information 
on each of the available packages. 


While using Fink, you can pick and choose which of the 
information columns you want to see by selecting or 
deselecting them from the View menu. Latest is the most 
recent available version. installed is the version that is 
currently installed on your system. Binary is the most recent 
binary version. Stable is the most recent stable version. 
Unstable is the most recent unstable version. Status is the 
status of your installation — current or outdated. Category 
is the software category, such as base, crypto, database, or 


game. Description is a description of the tool. Maintainer is 
the name of the person who maintains the tool. 


You can also filter the list by selecting a column, such as 
Name, from the menu in the toolbar. When you select a 
column, you can then type in your selection text in the field 
to the right. For example, you can list the available games 
by selecting Category in the menu and typing games into 
the text field. You can sort by any column by clicking the 
top of that column. 


When you download software, you can watch the progress 
of your download in the bottom window of the screen. 
FinkCommander even allows you to provide positive or 
negative feedback to the maintainer of a package by 
selecting the green for positive or red for negative stamp 
icons in the menu bar. 


MANAGE FINK WITH FINKCOMMANDER 


| @ FinkCommander File Edit View Source Binary Tools Window Help 
Packages: 769 Displayed, 51 installed 


nailed 
“’ Gee Se | SCRE 


FinkCommander file Edit View Source Bina Tools 


Packages: § Displayed, 51 Insta 


Window Help 


Instafied :Stable -Deseeiption Binary, 

1.4re5-2 Ascii are library 
aallb-bin L.4reS-2 Ascii art library ’ 
aalib-shtibs L.4rcS-2 = Ascii art library 
abiword 1.0.3-1 Open-source word processor : 
abs 0.908-1 Opensource spreadsheet 
afni 2.51e-2 Tools for analyzing FMRI data 
align 1,0.0-1 Text filter that vertically aligns columns 
amaze 0.0-2 Text-based 3D maze game : 
amor 3.0.7-3 KDE - themeable animated window toy 5 
anacron 2.3-3 Periodic command scheduler ; 

current analog 5.24-1 §.24-1 Program to measure usage on your web st 


app-defaults 20010814-: Creates an app defaults directory for fink e 


am Ro 


Click the FinkCommander 
icon to launch the utility. 
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“Description “Binary 
Soe checker mare intelligent than spell 

ispell tive spell-checker 

ispell—-french 1.0-1 Frenth ispeil dictionary 

ispell-german 20611124-: Gerrpan iKnpell dictionaries 


ispell-itatian 20G1-2 haliah ispeli dictronary 


Select Name from the m4 Click aspell to select it. 


drop-down menu. ; 
iH A binary format is not 


Type spell in the text field. available. 


®@ A stable source code 
version is available. 


The list updates to show 
only items with the word 
spell in their names. 


INSTALL UNIX APPLICATIONS 


As with Fink, FinkCommander configures, compiles, and You can also use FinkCommander to 
installs your software when you select Install from the Source remove software. The Remove option 
menu. The bottom left corner of the FinkCommander appears under each of the Source and 
window displays a message describing each phase of the Binary menus. 

installation. The message Done appears when the installation 
process is complete. At this point, the Status column for the 
newly installed tool contains the word current, telling you 
that you now have the current release of that tool. 


While the software installs, you can 
continue to peruse the list of available 
tools. This does not interfere with the 
installation process. You can select 


While the main purpose of FinkCommander is to make FinkCommander Help from the Help 
installing software easier, it also provides a convenient way for menu to better understand how to 
you to take an inventory of the software on your system. It take full advantage of this utility. 


provides a list of each package that is installed along with their 
version numbers, and the current or outdated status indicator 
tells you whether to install a newer version of a tool. 


Binary Tools Window Help FinkCommander File Edit View Source Binary Tools Window Help 


FinkCommander File Edit View JREEA 
Packages: 5 Disg 


install #1 


Reinstall o8 cy 
pea gall one | — aos Cuejory  tatet Description 
Rebuitd : amaze . games 0.0-2 Teat based 3D maze ™ 
Le 0 Fetch 4 pelt. cmatsix games 42a-1 Strolling ranGont tea’: 
urren ispell 3.2.06-3 3.2.06-2 ~ i conned4 5 games 1.2-1 Feat- based Connect | 
oo pes fi h Oe S Remove ORR cowsay a games 3.03-2 Configurable talking | i 
spelen 1.0-1 dama 5. games 0.5.4-1 Turkish draughts bow: # 
ispell-german 20011524- Seifupdate~cvs ORV danscan 5. games 0.5.2-1 Internationa’ draught: 
ispell-itatian 2001-2 1 Selfupdate ORS gothello 1 O.1-1 Small othetto game fe: } 
Update~alt OBA grhtino. 0.7.0-1 Strong othelio game | 


lincity 1.12pre49-2 1.i2predd-j]City Simulanon Gere: 
nibbles 41-2 11-2 Yext-pased colat saa: J 
othello 0.03-1 003-1 Consute tased Orhell: ig 
robotavmament 01.20.02-1 01.20.02-% [Robot board gerne in F 
tornada Ks “ Networhable text—bar’ 
wtf t= 1 Translates common | 
Farce Remove wif-acronyms fe Lest uf Common citer: 
xdigger 0. Boulderdash like garr j 


Run in Terminal >> 


Utilities » 


Click Source © Install. MB The software begins to 4 Type games in the text 


download. field. 


Select Category from the @ A list of downloadable 
drop-down menu. games appears. 


INSTALL LIBRARIES 


Y ou can install system libraries for your personal use or 


for use by software applications. While Mac OS X is 

an extremely versatile operating system, there are 
numerous libraries that you can download to increase the 
functionality of your system. Tools that you download and 
install often need some of these libraries. 


You install libraries in much the same manner as other 
software except that libraries are usually single binary files. 
When you place these files in the correct locations on your 
system, other software can use them by making calls to 
various routines. For example, if you install a library that 
contains routines for displaying graphics in the PNG format, 
you do not have to build these routines into your own code. 
Instead, you can use the library routines in your code and 
compile your software to dynamically load the libraries 
when you need them. 


System libraries are stored in /usr/lib. By convention, most 
third-party libraries reside in /usr/local/lib. You should be 
careful to install these libraries in the appropriate 
directories so that the applications that need them can find 
them. 


When you install libraries on your Mac OS X system, 
acquaint yourself with an environment variable called 
DYLD_LIBRARY_PATH. This variable is essential in helping 
your executables to locate the libraries they need. lf all of 
your libraries are not installed in /usr/lib, you must add the 
list of directories in which libraries are stored to the 
DYLD_LIBRARY_ PATH variable of every user. You must 
assign this variable a colon-separated list of all directories 
containing libraries. For tcsh users, you can insert a 
command, such as setenv DYLD_LIBRARY_PATH 
/usr/local/lib:/sw/1lib , to add these two 
directories to the locations where the dynamic linker 


searches for libraries. You can read the man page for DYLD 
to learn more about how the dynamic linker uses 
DYLD_LIBRARY_PATH as a search path for libraries. 


You can download many libraries by launching the 
FinkCommander utility, selecting Category from the menu 
in the toolbar, and typing libs in the text field; 
FinkCommander displays a list of libraries that it can install 
for you. 


When you install software through the traditional 
configure-make-make install process, you may have an 
opportunity to install libraries as well. This is because, 
although the basic make-install process may install binaries 
in /sw/bin or /usr/local/bin, it may fail to install necessary 
libraries. Read the README and INSTALL files to determine 
if there is an optional make install-1lib step that takes 
care of this. 


The table on the next page provides descriptions for a 
variety of libraries that you can install on your Mac OS X 
system. While incomplete, this list contains many of the 
most useful libraries that you are likely to find. Like other 
applications, libraries undergo changes as developers build 
and test new versions. 


Just as there are many locations from which you can 
download open source software, there are many places 
where you can find useful libraries. You can find references 
to any library you need by using a search engine such as 
Google. 


INSTALL UNIX APPLICATIONS 


CO 


The list below contains libraries that you may want to 
install on your Mac OS X system. These libraries are 
especially useful if you plan to develop software. 


LIBRARY DESCRIPTION LIBRARY DESCRIPTION 


fnlib Font rendering library for X11 System V poll(2) Emulation Library 


TIFF image format library 


freetype TrueType font rendering library, version 1 
GIF image format handling library, 


| 

Socal 
LZW-free version 

| 

| 


Graphics generation library General-purpose Web API written in C for 


Unix and Windows 
giflib GIF image format handling library, 
LZW-enabled version 
Low-level library that supports GTK+ 
and GNOME 


gmp 
gnomelibs 


XML parsing library 


General-purpose garbage collection library Low-level Unicode processing library 


C++ interface to the libxml2 XML parsing 
library 


XML parsing library, version 2 


Locale-enabling preload library 


Graphics manipulation programs and 
libraries 


Perl Compatible Regular Expressions 
library 


GTK+, the GIMP widget toolkit used 


ne General image-handling library | pil 


Networking library Terminal input library 


A library for generating PDFs 


The Python Imaging Library; adds 
image-processing capabilities to Python 


libdv Software decoder for DV format video 
libfame Fast Assembly MPEG Encoding library 


libghttp HTTP client library 


203 


X system. Lynx is a text-based Web browser that is 

useful for troubleshooting Web connections and 
accessing files and information from the Web, especially 
when you are limited to a text-only environment, such as a 
telnet or ssh connection. Lynx does not install with the Mac 
OS X distribution, but you can download it using Fink or 
FinkCommander. 


Y: can install the Lynx Web browser on your Mac OS 


While Lynx does not fill your screen with dancing frogs and 
pop-up ads, the simplicity of this tool gives you a definite 
advantage because it is fast. While Lynx recognizes graphics 
and links, it displays only the text equivalents. For example, 
in place of a link, you see [Link Name] or [Image Name], as 
in [company_logo.gif]. 


Terminal File Edit Scroliback Font Window Help 


[ferro:~] user% |[fink[ list] i] grep 


Lynx 2.8.4-2 Console based web browser é 
Lynx-ssl 2.8,4-2 Console based web browser ($SL-enabled) 
U 


LB Type fink followed by a 
space. 


4 Type grep lynx and press 
Return. 


ZH Type list followed by a 
space. 


Fink displays information 
about Lynx, including 
whether it is currently 


<A Type | followed by a installed on your system. 


space. 
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NSTALL THE LYNX BROWSER 


You can use Lynx to browse the Web as you would Internet 
Explorer and Netscape Navigator. To start Lynx, you can 
type lynx followed by the URL that you want to visit. 


You can click links, even though they appear as text, to 
move around within the site. You can use the arrow keys on 
your keyboard, the spacebar, or a number of single-letter 
commands. The third line from the bottom of the Lynx 
screen gives you suggestions as to what you may want to 
do next. For example, you may see a message such as press 
space for next page. To move forward in the document, you 
can press the spacebar, and to move backward you can type 
the letter b. As a text-only browser, Lynx seems strange at 
first, but you may find it a handy, and sometimes 
indispensable, tool. The name Lynx is a homonym for links. 


Terminal File Edit Scrollback Font Window Help 


Password; 
Reading package infc... 


7 Type lynx and press 
Return. 


Type sudo fink followed 
by a space. 


Type install followed by a 
space. 


Fink begins to download 
Lynx. 


INSTALL AND USE INTERNET APPLICATIONS 


You can set numerous options to define how You can use Lynx to perform basic troubleshooting 


Lynx works for you. The best way to learn about of Web sites. If you have trouble connecting to a 
these options is to consult the Lynx User Guide. Web site using a traditional browser, you can use 
To do this, type lynx localhost to start Lynx. Your Lynx to quickly determine whether the site is 

local home page displays. Then type h and press working. Because Lynx omits graphics and takes 
Return. This command activates the Lynx online very few resources to run, you can test and display 
help, and positions your active link on the Lynx your sites in very little time. If you are responsible 
User Guide. When you press Return, the User for a Web site, you can use Lynx to check whether 


Guide displays. You can use your arrow keys to 
move around within the User Guide. When you 
are done, you can use the Left Arrow key to 
move to your home page, or type the letter q to 
quit Lynx altogether. 


your site is up and working. 
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promis sie 


(ferro:~] user® sudo fink install lynx 

Password: 

Reading puckage info... 

Information about 769 packages read in S seconds, 


pkg lynx version ##4 
pkg lynx version 2.8.4-2 
The following package will be installed or updated: 


- p : yr ynxd.8.4. tar. ’ 
% Total ved % Xferd Average Speed Time curr, & 
Dload Upload Total Current Left Speed f 


3 1895k 3 71540 @ @ 2821 @ O:11:27 0:06:25 0:11:62 4a15[/f 


Fink uses curl to download Type which followed by a i The system shows where 
Lynx. space. the Lynx executable installs. 


Type lynx and press 
Return. 
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BROWSE THE WEB WITH LYNX 


appear to be a browser of limited capability, but as 

you become familiar with Lynx, you find how useful it 
is to quickly retrieve information from the Web; in less time 
than it normally takes you to start Internet Explorer, Lynx 
has your entire Web site on your screen. 


VY ou can browse the Web with Lynx. At first, Lynx may 


You can follow links, search for text, and download pages in 
a similar manner to using a normal browser. The difference 
is that, instead of clicking links that hide under images or 
display as underlined text, you move around with simple 
keystrokes. The currently active link appears highlighted. 
For example, the colors reverse so you see white letters on 
a black background if the rest of your screen is black on 
white. 


BROWSE THE WEB WITH LYNX 


FJ Type the name of a Web 
site that uses frames. 


LB Type lynx followed by a 
space. 


206 E} Press Return. 


With Lynx you can use single-letter commands to navigate 
the Web. For occasional browsing, you only need a few 
basic navigational commands, but if you want to learn the 
more advanced browsing capabilities of Lynx, you can use 
the Lynx help facility to learn what each of these one-letter 
commands means. To access the information on these 
commands, you can type lynx -help | less on the command 
line. You can also get help on using Lynx by typing the letter 
h after you have started Lynx. You can then open the Lynx 
User's Guide by pressing Enter or you can press your 
down-arrow key and then press Enter, to bring up a listing 
of the keystroke commands. 


If you find yourself stuck at any point or change your mind 
while waiting for a sluggish site to respond, you can type z 
to stop the current request. This command acts just like 
clicking the Stop button in Internet Explorer. 


@ Terminal file Edit Scroilback Font Window Help 


Your browser does not support frames.|We recommend upgrading your browser. 
Click here to enter the page: http://www. toad. net/~stockers/sandrich 


forlhelp, VG. to uu) <>" to "go back! 
+ Up Right ta follow a tink; Left to go back. 
H)elp O)ptions P)rint Go Main screen Qjuit /ssearch [delete]=history List L 


The server informs you that 
your browser cannot work 
with frames. 


INSTALL AND USE INTERNET APPLICATIONS 


Lynx highlights links on a Web site to make it easier for you to find them. 
When you first see a screen, the link nearest to the top of the page is 
highlighted. You can use the arrow keys to follow or move between links. 


The down-arrow key takes you to the next link on the page, and the up-arrow 
key takes you to the previous link. The left-arrow key allows you to follow a 
link backwards to the previous page; this is similar to the Back button on a 
normal browser. The right-arrow key follows the current link, taking you to 
the next page. The spacebar loads the next page. 


DESCRIPTION 


fT [Diplayalitt commands 
Ad the eurent tink to bookmas 
downoad the current 
fe Goto pected 
1 Jw an index of documents 
ik] Showa ist osinge key command and what Hey do 
a 
—_—— 
ae 
 ieniianaieiaaaial 
| 
————— 


KEY LYNX COMMANDS 


Return to main screen 


Set your options 


Search for a string in the current document 


Go to the next search string 
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Sandrich Progressive Entertainment (p1 of 7) | Sandrich. Progressive Entertainment (pl of a) 3 a 


(SandRichLOGofultG. gif} [SandRichLOGOful 1G. gif] 


The SandRich Kids The SandRich Kids 


; [Girl@ZsmallG.Kiyoke. gif] [Boy@ismal1G. gif] 
[Girl@1smallG_Claire. gif] [Boy@4smal1G_Chad. gif] 
(GirlO4smalLG. gif] [Boy@3smal16_ Vijay.gif] CGirl@3smal 1G, gif] 

Bobby - Kiyoko - Miguel - 


r ; F ' Click a Kid to Enter the Site 
The SandRich Kids are a bunch of ordinary kids from different ote 5 


neighborhoods, different family situations and different ethnic 


backgrounds ~~ ordinary kids all trying to find a way to be safe, The SandRich Kids are a bunch of ordinary kids from 


to make friends and to fit in, They willl take you through the 
adventure of becoming "Lifesmart” and Help you Learn te take care 
of yourself, get along with others and be a good “world citizen” 
while enjoying the wonder that is growilig up. Scroll down this 
page and “meet” as of the kids! 


Arrow keys: Up 3 ro move. Right tq follow a link; Left to go back. 


Hjelp Options P)rint Glo Main screen Quit /=search [delete]=history List i “A 


EZ] Press Return to continue. The initial page appears 


with the first link highlighted. 


different neighborhoods, different family situations and 

different ethnic backgrounds ~~ ordinary kids all trying to 
find a way to be safe, to make friends and to fit in, They 
will take you through the adventure of becoming "Lifesmart” 
and a Ou bata to ae 3 cere of yourself, get along with 


i keys: nn Right] to follow a link; Left to go ba 
[ferro: ~] user® U Yr 


5 Type q and press Return. J Type y to confirm. 


Lynx asks you to confirm 
that you want to quit. 207 


_ INSTALL WGET 


Y« can install Wget, an automatic Web-site retriever. Because Fink installs software into the /sw directory, Wget 


installs as /sw/bin/wget. After you complete the installation, 
you can type which wget and have this pathname returned 
to you. If not, you must update your search path to include 
/sw/bin by editing the .tcshrc file in your Home directory. 


Weget is a handy tool for downloading a Web site in 

order to back it up for safekeeping, or to move it to 
another host. The best feature of Wget is that you do not 
have to download your Web pages one at a time; the 
i: aa of ihe deel allows qalire dosynisadean Fink installs man pages in /sw/share/man. If you type man 
entire site with a single command. 

wget and get the response no manual entry for wget, you 

can add this directory to your MANPATH by adding setenv 


You can download W¢et using Fink. When you type the 
: 8 rel MANPATH /sw/share/man to your .tcshrec file. 


command fink list | grep wget, Fink tells you that the 


package is available and that it is not yet installed on your 

system. The current release of Wget is 1.8.2-1. To start the To make the changes to pe ea Pal and your : 

download using Fink, you can type the command fink Pieters eunatett) Qusem CeaeanG Hepes 

install wget. Fink then runs the cur1 command to they are defined in your .tcshrc file. Keeping these paths up 
‘ to date with the applications you have installed will save 


download the W¢get installation file. Fink manages the 
uncompression, extraction, and installation of the Wget files 
onto your system. 


you a lot of trouble in the end. 
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[fink list] i grep wget] 
1.8.2+1 Automatic web site retreiver ¥ Password: 

1.8,2-1 Automatic web site retreiver, with SSL support Reading package info... 

Informatian about 769 packages read in 5S seconds. 


(ferro:~] user® |] 


pkg wget version ### 
pkg wget version 1.8.2-1 

The following package will be installed or updated: 
wqet 

curl -f *L 9D Tip 


i/fftp.gnu.org/gnu/wget/weet- 1.8.2. tar.gz 


EE Type fink list followed by a Fink displays the Type sudo fink install wget Fink immediately starts the 
space. information it has on Wget. and press Return. download of Wget. 


4 Type | grep wget and press 
Return. 
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INSTALL AND USE INTERNET APPLICATIONS 


DOWNLOAD WEB SITES WITH WGET 


ou can download an individual Web page or an entire 

Web site with Wget. W¢get is an extremely fast 

command-line tool that retrieves files from Web sites 
using HTTP and FTP. You can download an entire site by 
typing a single line of text. 


Weget works well even on slow and troublesome 
connections, and if you are using a slow dial-up line, you 
can start the download and let it run. In all likelihood, it will 
run to completion with no monitoring or other attention. 
Wget can run in the background, making it an ideal tool to 
back up a Web site. 


To start a download, all you have to do is type wget 
followed by a URL. For example, the command wget 
http://www. dragonflyditch.com downloads the 
Dragonfly Ditch Web page; you will see this default 
document in your browser if you type the same URL. 


DOWNLOAD WEB SITES WITH WGET 


If you use the recursive option, you can download all of the 
Web pages and image files from the site. It is a good idea to 
download sites only if you know how many files you are 
downloading and how large they are. Downloads from a 
very large site could consume all of your free disk space. 
Wget creates a subdirectory by the same name as the URL 
from which you are downloading, so that if you download 
from multiple sites, Wget drops the files from each site into 
separate directories to avoid confusion. 


The W¢et tool includes many options, such as setting a 
username and password for access, limiting the depth of 
your retrieval, and determining whether Wget overwrites 
downloaded files. You can read the Wget man page to 
learn more about this tool. 


file Edit Scrofiback Font 


Terminal 


Window Help 


~=21:43:07-- 
=> “index html’ ¥ 

Resolving wew.sandrich.com.,. done, 

Connecting to www. sandrich .comf63. 2541.83.48] :80... 

HTTP request sent, awaiting response... 206 0K 


connected. 


513.67K/s 


SE a 


anoxs} S16 ETA 80:00) | 


21:43:07 (513.67 KB/s} - ‘index.html’ saved (526/526) 


[ferro:sitefiles] user’ 0 


DOWNLOAD A PAGE 74 Type a URL, and press 


Return. 


i) Type wget followed by a 


space. Weget downloads the page. 
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: wes dias a 
[ferro:~/uufe] users 
~-21:46: 38-~ 
=> “ww. uufeaston,org/index. html ‘ 
Resolving waw.uufeaston.org... done. 
Connecting to wev.uufeaston.org{216.231.134.199]:80... 
HTTP request sent, awaiting response... 200 OK 
Length: 334 [text/html] 


connected. 


326 .17K/s 
“wew uufeaston.org/index. htm 


Loading rebots.txt; please ignore errors. 
~=2E:46:47~~ http: //wew.uufeaston.org/ 
=> “wow, uufeaston.ora/robots. 


100% [emeneneasoseerscecsnnannnae>] 334 ETA 08:00 | 


21:46:47 (326.17 KB/s) ~ saved [334/334] 


HTTP request sent, awaiting response... ff 
21:46:47 ERROR 404: Not Found. 


~~21:46:47-- http://www. uufeaston.org/sideindex.htm 
=> ‘waw.uufeaston,org/sideindex. htm’ 

Connecting to ww.uufeaston. org[216.231.fi34. 199}: 88... 

HTTP request sent, awaiting response... 


connected. 


DOWNLOAD A SITE RECURSIVELY | [EJ Type a URL, and press 


Return. 


i Type wget followed by a 
space. 


Weget downloads the entire 


Z4 Type -r followed by a Bie 


space. 
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INSTALL AN IRC CLIENT 


ou can install an Internet Relay Chat (IRC) client 

on Mac OS X. IRC, or chat, clients allow you to 

participate in interactive dialog with other people on 
the Internet. Unlike e-mail dialog in which days may elapse 
between when you send a message and when the recipient 
reads the message, chat dialog is immediate. You chat with 
people who are active chat clients themselves. 


Chat tools, such as AOL Instant Messenger (AIM), are based 
on the IRC protocol. IRC relays your message between chat 
servers. If you do not have iChat on your Mac OS X system 
or if you want to upgrade your chat client, you can use the 
Get Mac OS X Software option on your Apple menu to 
access the download site for Apple binaries. From there, 
you can scroll down and find the AOL Instant Messenger 


application. By right-clicking the download link, you can 
select the Download Link to Disk option and then click 
Save to download the BIN file. When you double-click this 
file, it installs the AOL Instant Messenger software. 


Whatever chat client you decide to install, you probably 
want to keep it in the Dock so that you can start it up by 
clicking the icon. Before you can use any chat client, 
however, you need to register a screen name. If you are a 
.Mac subscriber, you can use your .Mac screen name. If you 
are already an AOL Instant Messenger user, you can use that 
screen name. Otherwise, you need to register a new screen 
name so that you can chat and so that other people can 
find you. 


& Explorer File Edit View Go Favorites Tools Window Help 
® Apple ~ Mac OS X - Downloads 


e ft *? & & 


Refresh Home : Autofill Print Mail 


Go1 770%: Demo * Lowntoad (32.0MB) 


Youll need cool strategic thinking and dynamite natural reflexes to triumph in this 


* Submit 4 File 
addictive action puzzle game. 


» Update Info 
y Safari Public Beta (¥60) (92/12/03) Freeware  & Download (2.8MB) = Feedback 


% |The fastest and easiest-to-use web browser ever for the Msc. 


nee en ae 
Ee toeNews. 


£2) Jinks te these apalizetions as ace 


ppli * af od therete, Any 
uot be directed is the 


Home > Mec OSX > Downloads 


In your Web Browser, 
go to www.apple.com/ 
downloads/macosx. 


¥4 Type AOL into the 
search box. 
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_@ Explorer Fite Tools 


Favorites 


Relresh 


Home = AutoFill Print 
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Search Again 


ac OS X Downloads: Search Results. Re 
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“\ AsOust 
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Seamesry. About AOL for Mac OS XAQL for Mac OS X brings together enhancements to AOL’s popular e-mail and instant i 
Messaging features, such a3 a counter on the Mac OS X dock that displays the number of new messages; the new AOL 
Search; the addition of new sho ... 


a 


tant Messenger les you exchange instant Messages, share photos, chat?» 
Outed dinelindoming G jeeeeetis siiniiiiaiiemiaamaa, PlT t 
abe 


SP internet zone 


Wi The Mac OS X 
Downloads: Search 
Results page appears. 


eH Click the Email Chat - 
AOL Instant Messenger link. 


INSTALL AND USE INTERNET APPLICATIONS 


Other IRC clients are available for Mac OS X and__; You can also download an IRC client using Fink or 


offer various features that you may prefer to FinkCommander. To determine what clients are 
those of AIM. The site www.irchelp.org isa good | available through FinkCommander, type chat into 
place to get information on other chat clients; the text field and select Name and then Description. 
in particular, the www.irchelp.org/irchelp/mac/ This should provide you with information on chat 
page provides information on other chat clients tools, such as xchat, that you can download or 

and links to the sites where you can find these install with FinkCommander. 


tools. 


Ircle from www.ircle.com is one of the most 
popular chat clients for the Mac OS community. 
You can download the Carbon version of this 

tool for your Mac OS X system. 
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HM The AOL Instant Messenger E¥} Click the Download link. i The Download Manager 
page appears. downloads your file. 


“7 Scroll to find the 
download link. 
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CHATTING ON IRC 


Y ou can chat with a person when you know their 


screen name. A screen name enables you to find 

someone on IRC and determine whether the person 
is online. When you know the screen name of another user, 
you can add the user to your buddy list, thereby making it 
easier for you to open a chat session with the friend. 


When you first open iChat, your buddy list appears and you 
can determine which of your buddies are available to chat. 
You can add buddies to this list by using the Add a Buddy 
option from your Buddies menu. When you select this 
option, a form appears that you fill out with information on 
the new buddy. This information includes the full name and 
screen name of the buddy. You can also use this form to 
keep track of the e-mail address of your buddy. 


After you select a buddy, you can invite that buddy to chat 
with you by right-clicking the buddy from your buddy list 
and clicking Invite to Chat. 


ar te ee 
TTING ON IRC | 


| « iChat File Edit View Buddies Format Window Help 


Click iChat in the Dock. 


®@ The Buddy List panel 
opens. 


Because you may not always be in the mood to chat, you 
can alter your status to control whether others can initiate a 
chat session with you. When you start iChat, you are listed 
as Available. You can change this status to Away, or you can 
even create a custom status to tell your buddies when you 
are too busy to chat. 


When you engage a buddy in chat, you can exchange dialog 
in a chat window. For example, if you start a chat with 
someone from your buddy list or select New Chat with 
Person from the File menu, a dialog window then opens in 
which your dialog with the other person appears with 
proper annotation so that you can easily see what each of 


you is typing. 


@ iChat File Edm View BEIRESE Format Window Help 


Add A Buddy... 3 ih ' 


favite To Chat... 

Send instant Message... 
Semi Direct Messate:.. 
Send Email 


Mateos fH 


Send A File... 


#4 Click Buddies > Add a 


Buddy. 


you can download and install a command line 
IRC tool called ircll from www.irchelp.org/ 
irchelp/ircii. You download a TARGZ file from 
this site, which you can compile and install. 


After installation, when you type ircii, your 
Terminal window splits into two sections. You 
then use commands such as /server and 


learn some basic commands, and the /quit 
command to exit the program. 


File Edit View Buddies Format Window Help 


Macintosh HD 


El Type the information 
about your new buddy in 
the text fields. 


LEY Click Add. 


Mi The Buddy List AIM screen 
opens. 


INSTALL AND USE INTERNET APPLICATIONS 


If you like working on the Unix command line, 


/ join to connect to a chat server and join in a 
discussion. You can use the /help command to 


While IRC clients such as iChat provide the means 
for you to chat with people around the globe, there 
are other tools that you can use in UNIX to 
communicate with other users. One of these tools 
is called talk. Talk allows you to enter a chat-like 
session with other users on the same system. You 
can read the man page for more information. 


@ iChat file Edit Vew Buddies Format Window Help 


= 


Marintosie yo 


al @ Ory 


| __ invite To Chat... 


Send instant Message ‘ 
Send Direct Message... 


Your new buddy appears in b Click Invite to Chat. 


pre"Bucdy. Listas: Bi iChat tells you whether 
Right-click to select a your buddy is available. 


buddy from your list. 


UNIX FOR MAC 


CONFIGURE SENDMAIL 


ou can configure sendmail on your Mac OS X system. 

Sendmail is a mail server; it can listen for e-mail 

requests from other systems. Sendmail configuration 
is one of the most difficult tasks in Unix administration. The 
software itself is complicated and its initial deployment on 
Mac OS X brings along some additional problems that must 
be resolved. However, with a little care and some insight, 
you may get off easily and end up with a mail server that 
behaves properly. 


Some of the difficulties related to sendmail on Mac OS X 
are due to a conflict between the way that Mac OS X and 
sendmail deal with directory permissions. Where sendmail 
wants to be sure that directories it uses can only be 
modified by root, Mac OS X is far more lenient about 
directory permissions in order to support privileged users 
who want to do things like dragging files into root-owned 
directories. If you try to start sendmail using the default 
configuration, sendmail will balk at world writable 
directories and not start. 


The easiest way to resolve the conflict between sendmail's 
cautious character and the lenient directory permissions of 
Mac OS X is to modify the DontBlameSendmail setting in 
sendmail's configuration file. This name refers to the fact 
that the developers of sendmail do not want you blaming 
the software if you reduce its level of security. Modifying 
the setting will, however, allow sendmail to start and will 
not reduce your system security. 


Sendmail's configuration file is stored in /etc/mail and is 
called sendmail.cf. You should always use care in editing 
this file as the lines in this file are difficult to understand 
and easy to mistype. However, it is not especially difficult to 
generate a new sendmail configuration file and the tools 
you need to do so are already on your system. 


File Edit Scroflback Font Window Help 
tye 


: a 


EDIT SENDMAIL.CF FA Press Return. 


Type sudo vi 
/etc/mail/sendmail.cf. 


| 2 
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# Copyright Cc} 1998-2001 Sendmail, Inc. and its suppliers. 

# All rights reserved. 

# Copyright (c} 1983, 1995 Eric P. Allman. All rights reserved. 

# Copyright (c> 1988, 1993 : 
# The Regents of the University of California. All rights reserved: 


a 
* 


By using this file, you agree to the terms and conditions set 
forth in the LICENSE file which can be found at the top level of 
the sendmail distribution. 


eRRH HH 


BBHASHAARRENSHNR EHH YHRARAER HER ARRAHAR ERIS ARNE AY BEY MAREE HUES BARRE 
ANB BEHIR EAH EHE HE HIN PARE YF ROOLY HTH AHHH EAHA R EH ARDEA TR BEER R EY a 


SENOMAIL CONFIGURATION FILE 


EJ) Type /DontBlame and 
press Return. 


@ The editor opens your file. 


INSTALL AND USE INTERNET APPLICATIONS 


To ensure that sendmail does not read its 
configuration file from Netinfo, you may need to 
type the following commands found in the 
/etc/mail/README file: 


if you have trouble starting or running sendmail, you 
can check your /var/log/system.log file for messages 
that may pertain to the problem. If you see an error 
message that the file /etc/mail/access.db does not 
exist, you can create this file from /etc/aliases with 
the command makemap hash /etc/mail/ 
access.db < /etc/aliases. The /etc/aliases 
file contains lines such as test: user where test 
is an alias and user is a real username. 


niutil -create /locations/sendmail 


niutil -createprop . /locations/sendmail 
sendmail.cf /etc/mail/sendmail.cf 


These commands tell sendmail, whenever it tries 
to look at NetInfo, to look instead at /etc/mail/ 
sendmail.cf. 


If you encounter errors that indicate you cannot 
write temp files, you must open permissions 

on the /var/spool/mqueue and /var/spool/ 
clientmqueue directories. You can do this with the 
command chmod 777 /var/spool/*mqueue. 
These directories are used to temporarily store 


the details and content of e-mail messages 
before the messages are delivered. 


Terminal a3 Edit Scroliback Font Window Help 


# level 16 config file format 
V10/Berkeley 


# override file safeties ~ setting this option compromises system cated 


¥: 
# addressing the actual file configuration problem is preferred : 
# need to set this before any file actions ore encountered in the cf File: 


w) DontB LameSenamai l=safe 


default LDAP map specification 
eed to set this now before any LDAP maps are defined 
#0 LDAPDefaultSpec=-h localhost 


PHPEAHABRARHEH RARE 
# lecal info # 
RERPMRASH NS AEE EO 


: od LOAP caeare 


Your cursor moves to the 
line you need to edit. 


| Type :s/#O DontBlame 
Sendmail=safe/O DontBlame 
Sendmail=GroupWritableDir 
PathSafe/ and press Return. 


Terminal file Edit Scroliback Font Window Heip 


#HOHY = SId: proto.a4,v 1.1.1.4 2002/03/12 17:59:50 zarzycki Exp % ##iHHE r 


# level 10 config file farmat 
V10/Berkeley 


# override file safeties ~ setting this option compromises system securit 


Ys 

# addressing the actual file configuration problem is preferred ; 
# need a set this before any file actions are encountered in the cf file” 
0 DontBlameSendmait=GroupritablebirPathSafe i 


# default LDAP map specification 
# need to set this now before any LDAP maps are defined 
#0 LDAPDefaultSpec=-h localhost 


RABHAHEAAHACAH AER RE 
# local info # 
BEER SHEAR 


# my LDAP cluster 


Your edits appear. 3 Save your file and exit vi 


by typing :wq and pressing 
Return. 


CONTINUED b> 
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CONFIGURE SENDMAIL (CONTINUED) 


two things. For one, you would edit the sendmail.cf 

file and then try starting sendmail again. The line #0 
DontBlameSendmail=safe will have to be changed to 0 
DontBlameSendmail=GroupWritableDirPathSafe. 
Another way is to generate an entirely new configuration 
file. While this may sound like it would be a lot more work, 
the file that you need to edit to generate a new configuration 
file is far more approachable than sendmail.cf. In addition, 
while you are at it, you can also add some other useful 
options to your configuration. 


T o modify DontBlameSendmail, you would do one of 


To start the process of creating a brand new configuration 
file, you will make a copy of the default mail configuration 
file. To find this file, you will move into the /usr/share/ 
sendmail/conf/cf directory. The default file is called generic- 
darwin.mc. Your copy should be called yourdomain. 

mc, though you can replace yourdomain with your domain 
name if you have one. The basic idea is to preserve the 
original file for safekeeping. 


CONFIGURE SENDMAIL (CONTINUED) 


You then want to edit this file. The lines of interest are all 
lumped together at the bottom. After the first line starting 
with the word define, you should add a line that reads 
define ('conf£DONT_BLAME SENDMAIL', 'GroupWrit 
ableDirPathSafe') . Then, save file. 


The next thing you need to do is run m4 to use the 
specifications that you just edited into a new configuration 
file. That command would look like this: m4. . /m4/cf.m4 
yourdomain.mc > /tmp/sendmail.cf. That leaves 
your new configuration file in /tmp. You then back up your 
current configuration file and install your new configuration 
file in its place. You then start sendmail. 


To ensure that sendmail starts up every time your system is 
booted, you need to modify /etc/hostconfig. This file plays 
a critical role in starting services. You will change 
MAILSERVER=-NO- to MAILSERVER=-YES-. 


PARTE RO 


*l|cd f/usr/share/sendmari/cont/c 


[ferro:~] user®|sudo cp generic-darwin.mc yourdomain.me 
Password: 


[ferro:~] userk [vt yourdonatn.md]| 


GENERATE NEW 
SENDMAIL.CF FILE 


iB Type cd /usr/share/ 
sendmail/conf/cf and press 
Return. 


74 Type sudo cp generic- 
darwin.mc yourdomain.mc 
and press Return. 


A copy of the generic file 
is created. 


<3 Type vi yourdomain.mc 


ES and press Return. 


@ ‘Terminal File Edit Scroiiback font Window Help 


divert(-1) 

# 

# Copyright (c} 1998, 1999 Sendmail, Inc. and its suppliers. 

# All rights reserved. 

# Copyright €c) 1983 Eric P. Allman. All rights reserved. 

# Copyright (c} 1988, 1993 
The Regents of the University of California. AL1 rights reserved. 


By using this file, you agree to the terms and conditions set 
forth in the LICENSE file which can be found at the top level of 
the sendmail distribution. 


# 
# 
# 
# 
& 
# 


# This file pravides o very generic configuration for sendmail. 
# 
# To customize your configuration, you probably don't want to edit this f 


/*det ine || 


& 
e 


£3 Type /*define and press 
Return. 


@ vi opens your new file. 


INSTALL AND USE INTERNET APPLICATIONS 


You can test sendmail by typing the words in blue in the following interaction. 


Example: 

[ferro:~] user% telnet localhost 25 

Misvarig) 227/10 Oleleer 

Connected to localhost. 

Escape character is ‘*]'. 

220 ferro.local ESMTP Sendmail 8.12.2/8.10.2; Tue, 24 Jun 2003 19:46:36 -0400 (EDT) 
hello whatever.org 

250 ferro.local Hello localhost [127.0.0.1], pleased to meet you 

MAIL FROM: rustydog@whatever.org 

250 2.1.0 rustydog@whatever.org... 
RCPT TO: user 
250°2.1.5 wser,.; 
DATA 

354 Enter mail, end with "." on a line by itself 


Sender ok 


Recipient ok 


this is a message 
a 


250 2.0.0 h50NkaCw000883 Message accepted for delivery 
quit 

221 2.0.0 ferro.local closing connection 

Connection closed by foreign host. 
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esene 
n /usr/share/sendmail/conf for more information on how t 4 
ee 
Go > 
# generate a new one with the features and values you want. The file READ® 
ME : 
# in that directory has instructions. 
HH 


forth in the LICENSE file which can be found at the top Level of 
the sendmail distribution. 


VERSIONIDC’ $Id: generic-darwin.mc,v 1,3 2002/04/12 18:41:47 bbroun Exp $7 5 

2) : divert(@)dn1 

OSTYPECdarwin)dal 

DOMAIN(genericddnl Hae 

undefineC” ALIAS _FILE') # This file provides a very generic configuration for sendmail. ; 

jHefined PROCMAIL_MAILER_PATH', “/usr/bin/procmail') # : 
E_SENDMAL § # To customize your configuration, you probably don't want to edit this f: 

yourdomain,me: 39 lines, 1322 characters. ; 


FEATUREC ‘access_db "dnl 
MAILER (smtp) 


[ferro:~} user%[sudo mv /tmp/sendmail.cf /etc/mail/sendmai b,c 
[ferro;~] user%|sudo sendmail -bd a | 


[ferro:~] user® 


Your cursor is positioned at 
the first line starting with the 
word define. 


BB Type the letter o. 


HA new line opens up. 


6 Type define( confDONT_ 
BLAME_SENDMAIL', Group 
WritableDirPathSafe') and 


press Esc to exit input mode. 


L@ Type :wq and press 
Return to save your file and 
exit vi. 


J) Type m4 ../m4/cf.m4 
yourdomain.mc > 
/tmp/sendmail.cf 
and press Return. 


Ey Type sudo mv 
/etc/mail/sendmail.cf 
/etc/mail/sendmail.cf. date 


+%y%m%d and press Return. 


ut) Type sudo mv 
/tmp/sendmail.cf 
/etc/mail/sendmail.cf 
and press Return. 


Lull Type sudo sendmail 
-bd -qi5m. 


i 


i 
ia 


ou can create and send messages from the command 

line in Mac OS X, as you can with most UNIX systems. 

You do not need to open up a mail client. The easiest 
and fastest way to do this is by using the echo command to 
create a message and then piping the message to the mail 
command. For example, you can type the following message 
on the command line to create a message with the subject 
line lunch and add it to the inbox of user shs. 


echo Please do not forget we have a lunch 
date today | mail -s "lunch" shs 


If you want to send a longer message, you can run the mail 
command — for example, mail shs — and then type your 
subject line and message. When you are finished typing 
your message, you enter a period (.) on a line by itself, and 
the system sends the message. 


SEND E-MAIL FROM UNIX 


Your recipient can read your message in a variety of ways. If 
they are a command line user like you, they may opt to use 
the mail command by typing mail on a line by itself. A list 
of messages appears, and they can read them one at a time 
or delete them without reading them. If they want to 
respond, they can do that, too. The mail command 
includes the arguments r for reply and d for delete. To read 
a message, the user simply presses Return or, in the case of 
multiple e-mails, selects the message number and presses 
Return. If your system is set up with a mail client, such as 
pine or elm, you may prefer to open your mailbox using 
one of these tools. 


SEND E-MAIL FROM UNIX 
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os x tics 3209) LEE Fg ONT 


erro:maitj userklecho “Can you read this? i mail -s “test” ; 
{ferro:moil] user® [| 


SEND A MESSAGE 


74 Type | mail -s "test" 


1 Type echo "Can you read followed by a space. 


this?" followed by a space. EJ Type your username, and 


press Return. 


space and the name of a user, 
and press Return. 


prompt, and press Return. 


Terminal Fite Edit Scroliback Font Window Help 


jokes until I get there. I need everyone to be in a good mood. 
Thanks ~~ 


cae 


£0T 


{ferro:~] user% [] 


AN HA VOLO 20 OOM BRENT RP UR THIIRI UANNL # tte 


prego, arses cereTRUR RSH ENE At 


Type mail followed by a J Type your message, and 


press Return. 


Type a dot (.) ona line by 


Type a subject line at the itself, and press Return. 


@ The mail system delivers 
your message. 


INSTALL AND USE INTERNET APPLICATIONS 


While the mail command is useful, most UNIX The mail command is also very helpful for use 
users today prefer to use more versatile tools for | within scripts. For example, if you write a script to 


sending and receiving e-mail. The simple mail routinely check disk space, you may want the script 
command, after all, cannot properly display to send the results of the disk check to you via 
e-mail that arrives in HTML format or allow you e-mail. You can use a line of code such as df -k | 
to fetch and use attachments. The mail mail -s "disk usage" user@mydomain.org 
command was created before HTML and in a script that runs once a day through cron to 
attachments were used in e-mails. remind yourself to look at your disk space. 


Even so, the mail command continues to 
provide a service. For example, simple e-mail 
messages sent from the command line can help 
you to determine whether a mail server is 
working. 


Mail files, typically thought of as inboxes, are 
stored in /var/mail. Each user on the system 
with pending mail will have a single file in this 
directory. The inbox for user would be 
/var/mail/user. 
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Wed Jun 25 67:17 13/359 “test” 
Mail version 8.1 6/6/93. Type ? for help. Wed Jun 25 07:17 18/498 "today’s meetin” 
"/var/mail/user": 2 messages 2 new 
>N 1 = shs Wed Jun 25 67:17 123/359 “test” 
N 2 shs Wed Jun 25 07:17 18/498 “today's meetin" 


& |] 


Message 1: 

From shs Wed Jun 25 97:17:56 2003 

Date: Wed, 25 Jun 2603 07:13:18 -@400@ (EDT) 

From: Sandra Henry~Stocker <shs> 

To: user 
> Subject: test 


Can you read this? 


Message 2: 

From shs Wed Jun 25 @7:17:57 2003 

Date: Wed, 25 Jun 2003 07:15:27 -04@@ (EDT) 
From: Sandra Henry-Stocker <shs> 

To: user 

Subject: today’s meeting 


I will be arriving late to the meeting this afternoon. Please tell 
jokes until I get there. I need everyone to be in a good mood. 


READA MESSAGE The mail system presents 73) Press Return and read the =‘ The mail system displays 
Type mail and press you with a list of waiting first message. your messages. Typing q will 
Return. oe exit mail. 


<3 Type the number 2 and 
press Return to read the next 
message. 


LOOK AT YOUR MAIL FILE 


ou can examine your Unix inbox without using 

commands, such as mail or mail clients like Mac OS 

X's Mail, by locating and displaying your mail file in 
your file system. Any time your mail setup does not appear 
to be working properly, knowing where and how to 
examine this file will help you determine whether mail is 
arriving as it should. 


To view your e-mail inbox, you should move into the 
/var/mail directory. This folder will contain a mail file for 
each user on your system who has mail in his or her inbox. 
Even if you have 300 individual messages, your inbox will 
consist of a single file. Each message in this file will begin 
with a From line that includes the sender and the time and 
date that the message arrived. For example, the line From 
gumby@example.org Mon Feb 17 15:30:02 2003 


will indicate the start of the message you received from 
Gumby on that date. Each message in your inbox will begin 
with a line that has this form. No other lines in your inbox 
will begin with the word From followed by a space. These 
lines allow mail clients to determine where each message 
starts. The message header lines that begin with tags such 
as Date:, From:, To:, and Subject: come next and are 
followed by the text of the message that was sent to you. 
The end of each message is only indicated by the beginning 
of another message or the end of the file. 


If you send a message to yourself on the command line, using 
a command such as echo testing | mail user, you 
should see the size of your inbox increase, the timestamp 
on the file to change, and the content of this message 
added to the bottom of your mail file. 


LOOK AT YOUR MAIL FILE 
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eee = 
{ferro:mail] user%]1s -1] 
total 16 
ja om mom a i eastocke mail 
wnanaon 1 kbartlet mail 
eine nem i shs mail 
eMieereonere =f user mail 
{ferro:mail] user® || 


343 May 21 21:59 eastocker 
1032 Jun 25 08:37 kbartlett 
1446 Jun 25 08:21 shs 

826 Jun 25 08:37 user 


A) Type cd /var/mail and press 
Return. 


74 Type Is +I and press 
Return. 


§ A listing of mail files on 
your system displays. 
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5@6 Jun 25 68:39 user 
From shs Wed Jun 25 08:37:24 2003 
Return-Path: <shs> 
Received: (from shs@Localhost) 
by ferro.local (8.12.2/8.12.2) id h5PCO22m@Q1492 
for user; Wed, 25 Jun 2003 08:24:02 -@4@0 (EDT) 
Date: Wed, 25 Jun 2003 08:24:02 -@480 CEDT) 
From: Sandra Henry-Stocker <shs> 
Message-Id: <200306251224.hSPC022m001492@f erro. Local> 
To: user 


Subject: today's meeting 
Status: 0 


I will be arriving late ta the meeting this afternoon. Please tell 
jokes til I get there. I need everyone to be in a good mood. 


Thanks -~ 


Type more followed by the 
name of your mail file, such 
as user, and press Return. 


The top of your mail file 
displays. 


INSTALL AND USE INTERNET APPLICATIONS 


FETCH E-MAIL FROM OTHER SERVERS 


fetchmail tool. Fetchmail is a retrieval and forwarding 

tool that supports all of the important protocols for 
retrieving mail from an e-mail server. These include the most 
popular protocols — POP3 and IMAP — as well as a number 
of others: POP2, RPOP, APOP, KPOP, ETRN, and ODMR. 


Yi can fetch e-mail from remote servers using the 


Like many tools, fetchmail uses a configuration file, 
.fetchmailrc, to store information about your accounts. You 
can add lines like the following to your .fetchmailrc file: 


poll mail.mailserver.org protocol POP3 user 
nici password worx4me is noh 


In this example, nici is the username for the remote 
account, while noh is the local user. The server you check 
for downloadable e-mail is called mail.mailserver.org. As 
you can see, the password appears in clear text. For this 
reason, you must set permissions on the .fetchmailrc file so 


FETCH E-MAIL FROM OTHER SERVERS 


that only the individual user can read this file. In fact, 
fetchmail warns you if the permissions on the file are not 
set to 710. This means that the owner has read, write, and 
execute permission, while the group has only execute 
permission, and no one else can access the file. 


Storing the password in the file saves you from having to 
enter it each time you use fetchmail. This also allows 
fetchmail to automatically run through cron for daily or 
more frequent downloads. 


Your system must be running sendmail for fetchmail to 
work properly. Fetchmail works by transferring the mail to 
the smtp port on your local system. If you are not using 
sendmail, you can change your .fetchmailrc file to use 
procmail instead by making it look like this: 


poll mail.mailserver.org protocol POP3 user 
nici password worx4me mda "/usr/bin/procmail 
~d noh" 
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cexeTeR 


(Ferro-screenshots] user%|fetchmail -v|--keep -al>> /var/log/fetchmail 2>&il]] 2 


USE FETCHMAIL ON 
THE COMMAND LINE 


Type >> /var/log/fetchmail 
2>&1 and press Return. 


ui Type fetchmail -v followed 
by a space. 


i Fetchmail downloads your 
mail from the remote server. 
74 Type --keep -a followed by 

a space 


RUN FETCHMAIL THROUGH CRON 
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[ferro:~] user% su 2 
Password: 4 
[ferro:/Users/user] user# echo "11 23 * * * /sw/bin/fetchmail -a >> /var/) 
log/fetchmail 2>&1" >> /var/cron/tabs/user i 
[ferro:/Users/user] user# ps -ax | grep cron 

338 ?? Ss 0:08.18 cron 

1424 std R+ 8:00.08 grep cron 
[ferro:/Users/user] user# kill ~HUP 338 
[ferro:/Users/user] user# exit 
[ferro:~] user% crantab ~-1 
5 18 * * * /Users/user/check_space > /dev/null 


11 23 * * * /sw/bin/fetchmail -a >> /var/log/fetchmail 2>&1 


erro.~] users 


Pa Type 1123*** 
/sw/bin/fetchmail -a >> 
NvarNog/fetchmail 2>&1 
in your crontab file. 


1 Type crontab -e and press 
Return. 

PTSD Scere @ Your crontab file updates, 
and fetchmail runs every 
night at 11:11 P.M. 


INSTALL PINE 


ine is a text-based e-mail program that has been in 

use on UNIX systems for many years. You can install 

pine on your Mac OS X system using Fink or 
FinkCommander. Otherwise, you can download pine from 
www. Washington.edu/pine/getpine. You can then 
uncompress and untar the installation file as is described in 
Chapter 12. 


To create the pine application, you can type build osx. This 
command takes the place of the normal make command 
and builds a pine binary for your Mac OS X system. When 
the build process is finished, you have a directory 
containing the pine binary along with a series of other 
programs that you can copy to other locations on your 
system. You can refer to the README file for directions that 
may pertain to your installation. 


The first time you run pine, it creates a configuration file in 
your Home directory called .pinerc. This file allows you to 
modify a number of configuration parameters, such as how 
your name appears in messages that you send. Like most 
UNIX configuration files, the .pinerc file contains numerous 
comments; any line starting with a # symbol is a comment. 


To make pine easy to use, you should ensure that it is on 
your search path. This allows you to start pine by typing 
pine on the command line. You can verify that pine is on 
your search path by typing which pine. This command 
returns the full path to the pine executable. 


Some of the other tools that are compiled along with pine 
are useful if your system is to act as a mail server. The 
imapd, ipop2d, and ipop3d tools are servers that allow mail 
clients to download e-mail. These tools support the IMAP, 
POP2, and POP3 protocols, respectively. 
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install pine 
Reading riche into... 
Information about 769 packages read in 5 seconds. 


pkg pine version #H# 

pkg pine version 4.44-2 

The following packoge will be installed or updated: 

pine 

curt -f -L -0 HE //¥tp.cac.washington.edu/pine/pinet 44. tar.gz 


tet execution of curl failed, exit code 19 
Downloading the file “pined. 44. tar.gz" failed. 


(1) Give up 
(2) Retry the same mirror 
(3) Retry another mirror 


How do you want to proceed? {2} [] 


INSTALL PINE WITH FINK A warning may appear 


saying Fink failed to locate 


4 . . . 
Type sudo fink install pine the software. 


and press Return. 


INSTALL PINE FROM ATAR FILE 
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'52/CPYRIGHT 
./pine4 .52/README 
./pined,52/build 
./pine4, 52/build. cmd 

Apined. 52/buildcyg 
./ptne4.52/contrib/ 

./pine4. 52/contrib/ports/ 
_/pine4.52/contrib/ports/vms/ 
./pined,52/contrib/ports/vms /readme.vms 
./pines .52/contrib/ports/vms/vmsbutld. com 

./pines. 52/contrib/ports/vms/vms_link.opt 

_/pine4. 52/contrib/ports/vms/vms_muLltinet_Link opt 
./pine4.52/contrib/ports/vns/vms_netlib_link, opt 
./pineé, 52/contrib/ports/vms/vmsbui Ld_cclient. com 
./pine4 ,S2/contrib/ports/vms/readme. 1st 

./pine4s. 52/contrib/ports/aos/ 

./pine4. 52/contrib/ports/aos/README 

./pine4 ,.52/contrib/ports/aos/aos. diff 

./pines, 52/contrib/ports/sequent_ptx_4.4.6 
./pine4. 52/contrib/carmel/ 
ine4.52/contrib/carmel/pine/ 
.52/contrib/carmel/pine/makefile.ult, patch 


EJ Type the name of your 
TAR file or pine* and press 


1 
Type tar xvf followed by a Pee 


space. 
This command extracts the 
contents of your TAR file. 


INSTALL AND USE INTERNET APPLICATIONS 


You can start pine with a new .pinerc file two 
ways. You can remove your current file by typing 
rm .pinerc in your home directory. When you 
start pine the next time, it will greet you as if you 
had never used the program, setting up a brand 
new .pinerc file for you in the process. 
Alternately, you can type the command pine 
-conf > .pinerc in your home directory. This 
pipes the output of the pine -conf command, 
which generates the settings in a default .pinerc 
file to the file you specify. 
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[ferro:pine4.5Z} user% 
make args are (Cece osx 
Including LDAP functionality 
File /System/Library/OpenSSL/certs/factory|pem is missing 
This might indicote that CA certs did not get properly 
installed, If you get certificate validation failures 
in Pine, this might be the reason for them 


Including SSL functionality 

Moking ¢~¢lient Library, imapd, and ipopd 
eval make CC=cc SSLTYPE=nopwd SPECTALS=SSiDIR=/System/Library/OpenSSL osx 
make sslnoped 

moake[1]: “sslnopwd’ is up to date. 
Applying an process to sources... 
tools/an “in -s” src/c-client c-client 
tools/an “ln «s" src/ansilib c-client 
tools/an “Ln +s" src/charset c~client 
tools/an “Ln ~6” src/osdep/unix c~cLlient 
tools/an "in -s" src/mtest mtest 
tools/an "Lh -s* src/ipopd ipopd 
tools/an “In -s” src/imapd imopd 
tools/an “In ~s” src/maitutit mailutil 
toots/an “tn -s" src/mtock mlock 


Eos SSN TIN ANITA U OE PEE AA ELIS ERR ALI 0 NO NRL INS ETERS 


3 Type cd and the name of 
your new directory, and press 
Return. 


idl Type ./build osx and press 
Return. 


@ This command builds the 
pine software for Mac OS X. 


i Help 


5 Type bin/pine and press 
Return. 


Pine, by default, stores diagnostic information in 
files called .pine-debug1, .pine-debug2 and so on. 
These files might prove to be of some interest to 
you, but they are of no value. The easiest way to 
turn off this feature is to add the line alias pine 
"pine -d 0". to your .tcshrc file that sets the debug 
level or pine to 0. The next time you log on or type 
source .tcshrc, the .pine-debug files will no longer 
be created. Remember that you have to type Is -a 
to list files that begin with a period. 
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<<<This message will appear only once>>> 


Welcome to Pine ,.. a Program for Internet News and Email 


We hope you will explore Pine's many capabilities. From the Main Menu, 
select Setup/Config to see many of the options available to you. Also 
note that oll screens have context~sensitive help text available, 


SPECIAL REQUEST: This software is made available world-wide a$ o public 
service of the University of Washington in Seattle. In order to justify 
continuing development, it is helpful to have an ideo of how many people 
are using Pine. Are you willing to be counted as a Pine user? Pressing 
will send an cnortymous (meaning, your real email address will not 
be revealed) message to the Pine development team ot the University of 
Washington for purposes of tallying. 


Pine is a trademark of the University of Washington. 
Exit this greeting PrevPage 9 Print 
[Be Counted! ] NextPage 


@ The pine welcome page 
appears. 


READ E-MAIL WITH PINE 


ou can read your e-mail with pine. Using pine is not 

difficult after you get used to the pine commands and 

how pine organizes your e-mail. To start pine, you 
can type pine on the command line. When in pine, you can 
access your inbox, read and delete messages, and compose 
and send e-mail. 


The first screen of data that you see when you start pine is 
an upper-level menu that allows you to ask for help, 
compose a message, view a message in your current folder, 
list your folders, update your address book, or quit pine. 
You can access each of these options by typing a single 
command, such as C to compose a message. This screen is 
called the main menu. The default choice in the main menu 
is to list your folders; if you simply press Return, pine lists 
your folders. 


You can then open your inbox or another folder. The up- 
and down-arrow keys move you between messages. 

You can display a message by pressing Return. To return 

to the message index, you can type the letter i. You can 
mark a message for deletion by typing the letter d when 
that message is highlighted. This means that pine deletes 
the message when you quit the program. If you change your 
mind, you can un-delete the message by moving back to it 
and typing the letter u. 


While these one-letter commands may seem cryptic at first, 
pine provides a list of the most common commands at the 
bottom of the screen. You can return to the main menu by 
pressing the < key one or more times. You can get help at 
the main menu by pressing the ? key. To quit pine, you can 


type q. 
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Folder: (INBOX 35 Mes 


HELP Get help using Pine 
COMPOSE MESSAGE Compose and send a message 
MESSAGE INDEX View messages in current folder 
FOLDER LIST 
ADDRESS BOOK Update address book 
SETUP Configure Pine Options 
QUIT Leave the Pine program 

[Foider “INBOX” opened With 35 messages] GJ 


Help Previmd 
OTHER CMDS ff [ListFldrs] § NextCmd 


@ Pine opens, displaying the E21 Press Return twice. 


main menu. 


Lf Type pine and press 
Return. 
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21 Sandra Henry~Sto 
21 Sandra Henry-Sto 
28 Sandra Henry-Sto 
28 Sandra Henry~Sto 
28 Sandra Henry-Sto 
28 slee@achilles.tc 
16 Pharmacy ¢ 
16 Pharmacy € 
18 Drugstore ¢ 
16 brtsbiornyjxiéms ¢€ 
16 ee ahoo . 


= Gg ee -S-ae - -E -4 


16 YUSDROLpenet cues 4 
18 nitezephyr@msn.c  C€ 
1? Donald24sqxn@cs. 

16 ncdki@hotmail.co € 
15 Kathyrn ¢ 


Z2ZAZZEA 


Fldrlist @ Prevdsg 
OTHER ate [ViewMsg] = NextMsg 


@ A list of messages appears 
in your inbox. 


@ You can press the up- and 
down-arrow keys to move 
between messages. 


Window Help 


INSTALL AND USE INTERNET APPLICATIONS 


To reply to a message using pine, you can type r when 
you select the message in the message list or when you 
view the message. Pine addresses your reply to the 
sender of the original message and asks you whether 
you want to include the original message in your reply. 


You can change your pine options by editing your 
.pinerc file or by selecting SETUP from the main menu. 
If you elect to use SETUP, another list appears. Selecting 
C brings you to a long list of configuration options over 
several screens. Although these options are numerous, 
if you are like most pine users, you will stay with the 
default settings. 


To move a message to a different folder, you can type s 
when pine displays the message list or the message itself. 
Pine then asks you to type in the name of the folder 
where you want to place the message. It defaults to the 
saved-messages folder. 
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(328) saying hello 

(362) lunch 

(3@4) 

(384) 

(304) 

(368) 

1689) amazing youth regained 
1689) amazing youth regained 
3575) Viagra,Phentermine , Xenical 
1862) Look at F.H.W.! Q@82-3 


2386 coo e Md ae 


1779) *} Dont miss or . 


1341) Mortgage Aprroved.., get the hme 


2138) hey 
2911) Time in a bottle 


PrevPage # Delete & Reply 
NextPage @ Undelete Forward 


<3} Highlight the message 
you want to read and press 
Return. 


Date: Thu, 16 Jan 2003 18:17:45 -1008 
From: maxusmedic@msn.com 

To: ftp@tcsnet net 

Subject: Lose 32 pounds by February 


{ The following text is in the "iso-8859-1" character set. ] 
reat mueted for the "US-ASCII" character set. Jj 
C Some characters may be displayed incorrectly. J 


Hi! 


If you’re like me, you've tried EVERYTHING to lose 

weight. I know how you feel - the special diets, 

miracle pills, and fancy exercise equipment never helped 
me lose a pound either. it seemed like the harder I tried, 
the bigger I got, until I heard about a product called 
Power Diet Plus. 


Help Msgindex  PrevMsg PrevPage @ Delete § Reply 
OTHER CMDS @ ViewAttch # NextMsg NextPage # Undelete g 


@ The selected message 
appears. 


Forward r 


SEND E-MAIL WITH PINE 


compose a message in pine, you can type c while in 

the main menu. This moves you into a simple text- 
editor in which pine pre-inserts message parts such as the 
To and Subject tags. You can move around in this form by 
using arrow keys, inserting your recipient and your message 
text. 


Y= can compose and send e-mail with pine. To 


As you type your message, the form area dedicated to the 
message text grows larger to accommodate your message. 
To insert a text file into your message, you can press Ctrl + 
R. Pine then asks you to enter the name of the file that you 
want to insert into your message. You must supply the name 
of the text file, including the pathname if it is not located in 
your Home directory. 


Pine allows you to add carbon copy (cc) recipients to your 
messages and to include attachments. To add an attachment, 
you can type the name of the file, along with the pathname 
if it is in a subdirectory, in the Attchmnt line. Pine attaches 
the file to the message when you send it. You can add 
additional attachments by pressing Ctrl + J. 


To change the format of your message to a rich header, you 
can press Control + R. This adds some additional fields to 
your message header, such as Bcc and Newsgrps. If you 
have defined a signature, the contents of your signature file 
appear at the bottom of your message text. 


When you are ready to send your message, you can press 
Control + X. Pine asks if you want to send your message. 
If you type s, pine sends the message. The Control + X 
command and other options appear along the bottom of 
your screen. 
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Tpeeel 


Ell Type pine and press 
Return. 
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HELP Get help using Pine 
COMPOSE MESSAGE Compose and send a message 
MESSAGE INDEX View messages in current folder 
ADDRESS BOOK Update address book 

SETUP Configure Pine Options 


QUIT Leave the Pine program 


Copyright 1989-2002. PINE is a trademark of the University of Washing { } 
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© OTHER CMOS § [ListFldrs] J NextCmd 


H Pine opens, displaying the EB] Press C. 


main menu. 


INSTALL AND USE INTERNET APPLICATIONS 


Messages that you move to other folders are 
stored in files in your mail directory. For 


To add a signature to the messages you send with 
pine, you can create a .signature file in your Home 


example, if your username is sbob and your directory. Pine reads the contents of this file and 
home directory is /Users/sbob, your mail folders appends your signature to the bottom of every 
are stored in /Users/sbob/mail. Each file within message that you compose. You can create a 
this directory represents one of your mail signature file using any text editor or on the 
folders, and pine stores it as a standard UNIX command line. 

mail file. Messages begin with the string From, 

followed by the e-mail address of the sender, Example: 

and a date/time stamp. echo " -" > .signature 


' echo "Fred T. User, Minstrel" >> .signature 
If you copy a mail file to your mail directory or 


remove one, pine accomodates and lists the new 
set of folders. This shows that Pine does not 
maintain any internal representation of your mail 
folders. It simply looks at the files in your mail 
directory and displays them to you as a series of 
individual messages. 
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Ce : 
Attchmnt : 


=e Today’s Meeting 
MESS Peres Gat 
am going to be late to this afternoon's meeting, 


slides and donuts. Please tell jokes until I get there. I need for 
everyone to be in a really good mood. 


I am going to be late ta this afternoon's meeting, but I will bring 
| slides and donuts. Please tell jokes until I get there. I need for 
everyone to be in a really good mood. 


never on time never on tiie 


i Get Help R ileme P Cut Text Postpone =; 
ma Cancel i ‘ is & UnCut Texfl To Spell 


i Pine opens the Compose J} Type your message. @ Pine asks for confirmation Z@ Press Y to send your 
Message form. , ; before sending your message — message, or N to cancel 
Mi Pine adjusts the form to to the specified recipient. your message. 


Type an e-mail address in | accommodate your text. 


the To field, and press Return. @ Your message is sent. 


i Press Control + X to 
Type a subject for your send your message. 
e-mail. 


INTRODUCTION TO APACHE 


pache is the most popular Web server on the 
Internet today. Accounting for roughly 60 percent of 


Web servers and probably 80 percent of the available 


Web-server books, Apache is one of the open source 
products that has become a part of the foundation of 
the Internet. It is well used, well understood, and well 
implemented. 


| HOW WEB SERVERS WORK | WEB SERVERS WORK 


The purpose of the Apache Web server is to listen for 
requests from Web browsers and serve up the pages 


requested. Like any important Internet service, Apache 


runs on a dedicated port. This port is dedicated not to 
Apache, but to the HTTP protocol that Apache and 
browsers use to communicate with each other. 


After you install and run a Web service, curious visitors 
can type your URL into their Web browsers and peruse 
what your site has to offer. Whenever a visitor types an 


address such as www.dragonflyditch.com into a Web 
browser, the address is first passed on to a DNS server 
for translation into an IP address. Then, a request is 
made to port 80 on the remote system. This request is 
essentially GET / — a request for the home page or 
default document on your site. 


FREE AND CONFIGURABLE 


When a Web server receives such a request, it looks at 
certain configuration variables to determine which page 
it should send back to the client. For Apache servers, 
that page is usually called index.html, though with the 
prevalence of Java and other tools on the Web, it may 
just as likely be mainpage.jsp. If the home page is a 
static HTML file, the server transfers it to the client 
immediately. Many other types of pages are created 
only after the request arrives on the server, with 
information read from cookies on the computer of the 
client or from a database on the server. This information | 
allows customized pages to be created for each user. In | 
any case, when the page is ready, it is sent to the client. 
This all happens in a matter of seconds even when the 
server is halfway around the world. 


Apache is popular largely because it is free to any user, 
although this is not the only reason. Apache is also 
extensible through a collection of modules and can be 


modules at build time, so the resulting binary contains 
only the features that you need. Apache also supports 
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customized for an intended use. You can add or remove 


all of the features that anyone might expect in a Web 
server. Configuring Apache for name-based virtual 
servers, where multiple sites all run on the same 
machine while appearing to be independent, is easy in 
Apache. Configuring security and tuning the server for 
expected traffic are also simple processes. 


SERVE WEB PAGES WITH APACHE 


FITTING INTO THE INTERNET 


Web servers depend on the Domain Name System 
(DNS) to function, just like other Internet services. 
When you type a URL such as http://www. 
dragonflyditch.com, you are simultaneously specifying 
a number of things. By typing http, you are designating 
that HTTP is the protocol — the limited language that 
describes communications between client and server — 
used to communicate with the server. This is the 
primary protocol used by the Web, but not the only 


The configuration on the server end determines which 
directory on the server contains the documents and 
files available for viewing. For Apache, this directory is 
called the document root. On a properly configured 
Web server, visitors cannot view or download files 
outside of this directory. 


The configuration on the server end also determines 
which file the server transfers to you when you type 
www.dragonflyditch.com in the URL field. Whenever 


While a GET / request may at first appear to be a very 
modest service request, retrieval of the home page 
for most Web sites results in a number of requests as 
each frame and each image contained in the file is 
subsequently requested. Until your browser obtains all 
the parts of a page from the server, the Web page is 
incomplete. 


While the earliest Web servers delivered static Web 
pages to their clients, Web servers today often produce 
custom pages. For example, they may offer forms for 
you to fill out whose contents are posted, or sent to the 
server for additional processing, or they may call on 
encryption services to hide sensitive data from prying 
eyes as the data transfers to the server for processing. 


one. By typing www.dragonflyditch.com, you are 
identifying a particular server and relying on the services 
of DNS to translate this textual name into an IP address 
so that the DNS can use the IP of the address to locate 
and communicate with that server. By typing nothing 
more, you are indicating that you want to communicate 
with the server running on the default port for Web 
servers, port 80, and you are saying that you want the 
home page or default document for the site. 


you enter a URL that does not contain a filename, 
Apache looks through a list of default documents for 
one that matches a document in the requested 
directory. If the default documents list contains 
index.html and login.jsp, and the document root 
contains neither of these files, Apache returns to you 
one of two things: an error code or a directory listing. 
The choice depends on whether directory browsing is 
enabled. 


While the protocol that the Web uses to move files and 
data back and forth is itself fairly simple, with only a 
handful of commands such as GET and POST, the 
communications between client and server often 
include a jot of additional information. Much of this is 
contained in the headers that you send with your 
simple requests. Through the use of these headers, 
clients and servers can compare notes on what each of 
them is capable of doing. For example, a Web server 
does not send you a file in a format that your browser 
cannot display. When multiple sites are supported on a 
system, and differentiated only by their names — such 
as the difference between dragonflyditch.com and 
idy!llmtn.com — the server knows which site you are 
requesting because the site name is included in the 
headers. 


UNIX FOR MAC 


START APACHE 


software. The Apache installation includes a script 

that facilitates starting and shutting down the service. 
When Apache is not running, you can start it by typing 
apachectl start. The Apache bin directory must be on your 
search path for this command to work without a pathname. 
You will probably find Apache installed in /sw/apache, or 
usr/local/apache, and the script is bin/apachectl, but you 
can determine if it is on your search path by typing which 
apachectl. If you are using the Apache server that ships with 
Mac OS X, look in /usr/sbin. 


VY ou can start your Apache server after you install the 


When Apache starts, you can examine the processes 
running on your system; you can expect to see several 
processes named httpd. In a normal configuration, one of 
these processes is started by root, while another five to 
eight are started by a user called nobody. Nobody is a 
special user with no particular privileges on a Unix system. 
By running Apache processes as nobody, you ensure that a 
hacker 


@ Terminal File Edit Scroliback Font Window Help 


rro.~] user®| sudo Sw/apache bin/apachect 


Semen: ~] userk 


El ifa prompt appears, type 
your password, and press 
Return. 


Ll Type sudo 
/sw/apache/bin/apachectl 
followed by a space. 


4 Type start and press 
Return. 


M@ Apache starts running. 


230 


cannot commandeer these processes, and that these 
processes do not offer up files that only a privileged 
user should access. 


By starting up multiple servers, Apache can handle 
considerable traffic. While all connection requests from 
clients arrive at the same port, Apache turns over each 
request to one of the idle httpd processes. When all of the 
processes are occupied, Apache can start others. The ratio 
of busy to idle processes depends on specifications in the 
Apache configuration file. The number of processes grows 
and shrinks in such a way that the server is always prepared 
for additional traffic, but not so over-prepared that the 
overhead is excessive. 


When you install Apache, it is generally configured to start 
automatically when the server boots. However, if you change 
the Apache configuration file and want the changes to take 
effect immediately, you must restart the server with the 
apachectl restart command. 
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p 
.07 /sw/apache/sbin/httpd 
.06 /sw/apache/sbin/httod 
.88 /sw/apache/sbin/httpd 
88 /sw/apache/sbin/httpd 
.@1 /sw/apache/sbin/httpd 
06 /sw/apache/sbin/httpd 
.08 grep http 


Type ps -ax followed by a 
space. 


A list of the Apache 
processes appears. 


Type | grep http and press 


Return. 


STOP APACHE 


SERVE WEB PAGES WITH APACHE 


ou can stop your Apache server at any time. To stop 
Apache, you can use the apachect1 script with a 


stop argument. This stops all of the Apache processes. 


Both the stop and start commands are arguments to the 
script that you supply to Apache to control the operation. 
This script can also respond to restart and status 
arguments. The restart command shuts down and 
restarts Apache, while the status command tells you 
whether or not Apache is running. 


When you stop Apache, you terminate the server process. 
The server is no longer listening on the port assigned to 
HTTP, and clients who continue requesting service receive a 
message indicating that their browser has encountered a 
DNS error, or that it cannot find the server. This indicates 
that the client is not finding a responsive process on the 
HTTP port. 


Fite Edit Scrofiback Font Window Help 


sude_/sw/apache/bin/apachect1 


{ferro:~] user% || 


STOP THE APACHE SERVER <4 If there is a prompt, type 


your password, and press 


us Li pgrepoe Return. 


/sw/apache/bin/apachectl 


followed by a space. @ Your Apache processes 


74 Type stop and press tgp 


Return. 


Before you attempt to stop Apache, you may first want to 
confirm that it is running. You can do this in one of two 
ways. You can use the apachect1 script with a status 
argument; however, this technique only works if you also 
have lynx installed. You can also run the command ps _ - 
aux | grep httpd to view the processes that are 
running. If you run this command, you must be careful not 
to mistake your grep command for an Apache process. 


You can also determine whether the HTTP port is listening 
for client requests. If Apache is not running, no processes 
should be listening for connections on port 80. You can 
perform this test with the netstat command. The 
command netstat -a | grep httpreturns a LISTEN 
message when Apache is running. The output looks like this: 


tcep46 0 0 ‘7 heepe*, * LISTEN 


Terminal File Edit Scroliback Font Window ~ Help Log 
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{ferro:~] user® sudo /sw/apache/bin/apachect1 stop 
Password: 


erro:~] user%|netstat [-al! grep http} 
{ferro:~} userx |] 


CHECK FOR LISTENS 


3 
ON THE HTTP PORT Type | grep http and press 


Return. 


WNo LISTENs are reported 
for the HTTP port. 


LW Type netstat followed by a 
space. 


r4 Type -a followed by a 
space. 


CONFIGURE APACHE 


specifications. Configuration parameters for Apache 

reside in a single configuration file, and you can make 
configuration changes by editing this file. This configuration 
file is called httpd.conf, and it contains a great deal of 
explanatory text and examples to simplify the process of 
configuring your server. In fact, if you want to set up a Web 
site very quickly, you can simply install your custom Web 
pages in the default document directory and start Apache 
with the apachect1l start command. 


Y>: can configure Apache to run according to your 


APACHE DIRECTIVES 


The default location for Web pages is the htdocs directory 
in your Apache directory — for example, /sw/apache/ 
htdocs. When you install Apache, the installer puts a small 
set of files into this directory to act as a placeholder for 
your intended content. If you start Apache and visit your 
Web site without doing anything else, you see these 
documents. The logs directory stores log files that contain 
records reflecting each page that transfers from your site, 
including information on the client such as when they visit 
and from what system. The configuration directory, 
containing your all-important httpd.conf file, is called 
conf — for example, /sw/apache/conf. 


Configuration commands in Apache are called 
directives. The basic form of a directive is the name of 
the directive followed by the value that Apache assigns, 
such as User nobody. Each directive controls some 
aspect of how your Web server runs. While there are 
several hundred possible directives, you are not likely 
to make many changes in your default configuration 
file. lf you are curious, you can access a complete list of 
Apache directives by visiting www.apache.org. The set 
of available directives depends, in part, on the version 
of Apache that you are running. 


The most critical directives are DocumentRoot and 
Document Index. The DocumentRoot directive tells 
your Apache server where to go to retrieve pages when 
requests arrive from clients. The Document Index 
directive is a list of files that tells your server what files 
to look for when a client does not include a filename in 


BUILT-IN APACHE SERVER 


their request. If you do not set these two variables 
correctly, your Web server does not work as you intend. 


The ServerRoot is the directory in which the 
configuration and log file directories reside. If your 
Apache ServerRoot is /sw/apache, your configuration 
files reside in /sw/apache/conf, and your log files in 
/sw/apache/logs. In fact, your Apache binary is likely 
to reside there as well, in /sw/apache/bin. 


Although there are many other critical directives, most, 
if not all of these, default to very reasonable and secure 
settings. There are two forms of Apache directives: 
simple directives and block directives. Simple directives 
set a value for a specific setting, such as the port the 
server runs on. Block directives group other directives 
into a set, such as the settings you want to apply toa 
virtual Web server. 


Mac OS X ships with a built-in Apache server that you 
can configure and run without having to download and 
compile it from source code files. To start the server, 
you can click System Preferences > Sharing. When the 
Sharing panel appears, you can select Personal Web 
Sharing, and then click Start. if you open a Web 
browser and type http://127.0.0.1 in the URL field, a test 
page appears. 


The built-in Apache server is identified on your system 
as /usr/sbin/httpd. If you type /usr/sbin/httpd -V, a list 
appears which contains information about the settings 


that Apache uses, including the location of your default 
configuration file. The location of this file appears in a 
line that reads -D SERVER_CONFIG_FILE="/etc/httpd/ 
httpd.conf”. 


You can use the command grep “LoadModule 
/etc/httpd/httpd.conf to list any modules that are 
enabled. For example, cgi_module appears in the 
output of the grep command, indicating that CGls are 
enabled. It is a good practice to store CGls that you 
develop in the /Library/WebServer/CGI-Executables 
directory. 


SERVE WEB PAGES WITH APACHE 
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To enable PHP, you can remove the initial # symbol PHP Test File 

from the following lines in your httpd.conf file: Speait 

# LoadModule php4_module; # AddModule <body> 

mod_php4.c; # AddType application/x- <? phpinfo()?> 

httpd-php .php; and # AddType application/ </body> 

x-httpd-php-source .phps. You must then stop eye 

and restart Apache. After restarting, you can create the 

PHP test file and save it as /Library/WebServer/test.php. The built-in Apache server also initializes personal Web 
To confirm that PHP is working, you can type http:// sites for your users. For example, the personal Web site 
127.0.01/test.php into the URL field of your browser; if for the user Smith, is defined in the file /Users/smith/ 
PHP is working, a table appears containing information _Sites/index.html. You can find the access and error logs 
about PHP. for the built-in Apache server in the /var/log/httpd file. 


0 


The directives in the table below are some of the most want it to work. Most, if not all, of these reside in your 
critical in setting up your Web site in the way that you httpd.conf file, though some appear in comment lines. 


OPTION DESCRIPTION 


Options Specifies options, such as whether directory browsing is enabled 


<Directory name> and </Directory> Block directive for handling a specific directory 


DirectoryIndex Lists default documents, like index.html 


DocumentRoot Specifies directory where Web pages reside 


ErrorLog Specifies log directory relative to ServerRoot 

KeepAlive Determines whether sessions endure beyond the first request 
Listen Specifies port that server listens on, usually port 80 

LogLevel Determines what level errors should be logged 

MaxClients Sets a limit on the number of simultaneous connections 
ScriptAlias Connects a virtual name such as /cgi-bin/ with an actually directory 
ServerAdmin Provides e-mail address of Web site admin 


Identifies directory containing your Web pages 

Determines how many server processes run when the server starts 
Determines how many threads a single process may support 
Limits time that an inactive session is maintained 

Specifies userid under which Web processes run 

a aT), 
<VirtualHost pattern> ... </VirtualHost> _ 


UserDir Identifies directory name that is used for personal Web sites 


<VirtualHost pattern>..</VirtualHost> | Block directive for virtual hosts 


SET UP YOUR DOCUMENT DIRECTORY 


If your default document contains references to other files, 
such as image files, the links in your document must 
correspond to the directory structure that you create. For 
example, if you refer to an image called mylogo.gif that 
resides in the images directory within your document 
directory, you must refer to this file as images/mylogo.gif. 


ou can build a simple site using a single directory, or 

organize your Web pages using a series of directories. 

The document directory or document root that you 
set up for your Apache server holds all the files that are part 
of your site. These files can all reside in the directory that 
you assign to the Document Root directive, or you can, 
instead, divide your files into a series of directories to make 
them easier to organize. For example, if you use a lot of 
image files, you may want to keep these in a separate images 
directory apart from your HTML files. Most people find that 
it is distracting to have hundreds of files in a single directory. 


Your default document, index.html, not only has relevance 
to your document root, but it also plays a role in every 
directory that you create. Any time a visitor types in a URL 
ending in a directory name, your Web server attempts to 
send back a default document from that directory. If it 


The single point of entry for most visitors to your site is the does not find one, it returns a directory listing or an error, 


page that you set up as your default document, assigned to depending on whether you have disabled directory 
the DirectoryIndex directive in your configuration file. 
Called index.html by default, this is the document that your 
‘Web server sends to visitors whenever they type your URL 
into their browsers. 


browsing. 


SET UP YOUR DOCUMENT DIRECTORY 


ey Terminal 
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[ferro:~] user® /sw/apache/htdocs 
[ferro:htdocs] user% 
total 232 


erro:htdocs] user% 


[ferro:htdecs] user® 


~Pw-r-~re- 1 root admin 9892 May 26 23:32 analog@.htmt 
oPware-P-= 1 root admin 128@2 May 20 21:56 analagi.html 
~rwer--r-- 1 root admin 128@2 May 2@ 21:59 analog2.html 
“rwer-+p-- 1 root admin 9699 May 2@ 22:48 analog}. html 
-rw-re-r-- luser staff 2326 Jul 3 1996 apache_pb. gif 
-rw-t--r-~ louser staff 1385 May 38 2801 apache_pb.png 
-rwere--rs- louser staff 2414 May 3 2081 apache_pb2.gif 
-rw-r--r-- fuser staff 1463 May 328 2001 apache_pb2.png 
srwereere» touser staff 2160 May 3 2601 apache_pb2_ani.gif 
-PWwer--r-- 1 root admin 24805 May 28 23:32 code.png 
“rwer~<r-~ 1 root admin 2779 May 20 23:32 dir.png 
-rw-p--r-~ FT root admin 265@ May 2@ 23:32 dom.png 
drwxr-xr-x 3 root admin 182 May 22 11:87 images 
-ra-r~-r-< 1 root admin 59 May 22 11:82 index. btal 
erwere«r~~ lo user staff 2373 Aug 10 2082 index.html.var 
-Fw-p--r-= Lt root admin 2687 May 2@ 23:32 org.png 
srwere~r~= 1 root admin 2242 May 20 23:32 size.png 
~re-f--r-- 1 root admin 77 May 22 12:24 testme, html 
~Pwerespe~ 1 71 May 22 10:59 testme. php 
“Twepeepas 2 2981 May 2@ 23:32 


{ferro:htdocs] users [} 


DISPLAY CONTENTS OF YOUR Type Is -I and press CREATE A DIRECTORY El if there is a prompt, type 
DOCUMENT DIRECTORY Peltier. FOR YOUR IMAGE FILES your password, and press 


Type cd followed by a ull Type sudo mkdir followed _Return. 


i The contents of your 


oe document directory appear. by a space. i The system creates a 
74 Type the name of your 74 Type images and press directory for your image files. 
document directory, and Return. 


press Return. 
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SERVE WEB PAGES WITH APACHE 


CREATE A SIMPLE WEB SITE 


After you install Apache on your system, you can 

create a Web site by using a text editor to enter text 
and a few formatting commands, and by copying image files 
as you need them. 


Vi can create a simple Web site in less than an hour. 


Static Web pages contain special formatting commands in a 
language called HTML, along with the text or content of your 
pages. For example, if you create a Web site that you want to 
call My Life Story in 50 Words or Less, you can enter your 
title and your text and then proceed to insert the commands 
necessary to display the content as you want it to appear. 


If you type multiple paragraphs into your Web document 
without HTML formatting, the text that appears in a 
browser looks like a single long paragraph. To break this 
text into separate paragraphs, you must insert an HTML tag, 
<p>, in between your paragraphs. 


CREATE A SIMPLE WEB SITE 


Web pages must have the extension .htm! or .htm, and 
must start with a tag, <htm1>, that identifies the content as 
HTML. Most formatting commands in HTML have both an 
opening and a closing tag. For example, you start a Web 
page by typing the opening tag <html> and end it by typing 
the closing tag </html>. All closing tags in HTML follow the 
convention of starting with a forward slash (/). 


The simplest Web page, therefore, starts with <html>, 
contains text, and <p> markers to indicate paragraph 
breaks, and ends with </htm1>. A document as simple as 
this can constitute a Web site. There is no requirement that 
you insert images or links that point to other sites, or other 
pages in your own Web site. 
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EE start Pico by typing 

sudo pico /sw/apache/htdocs/ 
index.html replacing the path 
with your document root 
directory. 


<4 Type a line of text, and 
press Return. 


CY Type </html> and press 
Return. 


5 | Save your text, and exit 


2 h 
Type <html> and press =a 


Return. 
@ Your new home page is 
created. 
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“| testing, testing, 1, 2, three 


4 Open Internet Explorer 
from the Dock. 


Your new home page 
appears. 


J Type http:/Aocalhost 
/index.html into your URL 
field, and press Return. 
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INTRODUCTION TO HTML 


markup code. While you can use the HTML language 

to create extremely complex and extensive Web 
pages, you can also create attractive and functional pages 
by inserting a few simple HTML tags into your documents. 
These tags allow you to change the font of selected text, 
making it bold or turning it into a heading that stands out. 
They allow you to insert images, build tables, and insert 
links to other pages on your site or to other Web sites. You 
can also mark selected text as preformatted so that Apache 
does not wrap the text lines together. 


Y ou can create Web pages using the most basic HTML 


Most HTML tags come in pairs. That is, there is an open tag 
as well as a close tag. For example, if you want to underline 
a phrase in your document, you indicate the text you want 
to underline by inserting <ul> where the underlining 
should start, and </ul> where it should end. 


In some cases, you do not require tag pairs to format the 
text you want to change, but it is considered good form to 
use them. For example, if you mark the beginning of a 
paragraph by inserting <p>, you should also mark the end 
of the paragraph with </p>. Similarly, list items should 
begin with <1i> and end with </1i>. 


To insert an image into your Web page, you can use the 
<img src=url> command. In the simplest form, this 
command provides the location of an image file that you 
want to display within your Web page. However, you can 
also specify additional commands to control the size and 
placing of the image. 


To add a link to another page or Web site, you can insert a 
command such as <a 
href="http://www.idyllmtn.com">click 
here</a>. 


Terminal File dit Scroliback 


ADD AN IMAGE TO 
YOUR WEB PAGE 


ul Type sudo pico 
/sw/apache/htdocs/index. html 
and press Return. 


we Get Help @@ WriteOut MS Read File MM 
my Exit i 


Hi Pico opens with your 
current Web page. 


end of a line of text, and 
press Return. 


Pg Cut Text Cur Pos 


} Justify Bi} Where is UnCut Text§§j Te Spell 


<J) Type <p> and press 
Return. 


Position your cursor at the J Type another line of text, 


and press Return. 


SERVE WEB PAGES WITH APACHE 


The most fundamental HTML tags should enable you to construct a basic Web page. 


TAG(S) 


<html> and </html> 
<head> and </head> 


DESCRIPTION 


Start and end of HTML formatting 
Start and end of header 


<title> and </title> Start and end of title, often displayed in browser title bar 


<body> and </body> 


<p> and </p> 


<br> 


Start and end of body 
Start and end of a paragraph 


Insertion of a line break 


<a> and </a> 


<h?> and </h?> 


<li> and «</li> 


<img src="?"> 


Terminal file Edit ndow Help y 


<table> and </table> 
<tr> and </tr> 
<td> and </td> 
<th> and </th> 


Start and end of a cell in a table 


Scroliback Font Wi 


<html> 

testing, testing, 1, 2, three 
<p> 

This is where 1 live! 


<img src="images/oldhouse.jpd" width=-400 height=22@> 


Writedut 
Justify 


Zi Read File 


Get Help 
Exit i Where is 


(J Type <img src=" followed 
by the name of an image file 
in your documents folder or 
images directory. 


[3] Type width= followed by a 
number and height= followed 
by a number to control the 
size of your image. Then 

type "> and press Return. 


Prev Pg 


Cut Text Cur Pos 
y Next Pg 


UnCut Tex To Spell 


Save your text, and exit 
Pico. 


@ Your Web page now 
contains a link to an image. 


Start and end of a column header 


View Go 


[ ¢ Explorer File 


Buck Pata Home 


This is Where | lve! 


Wy geaades3g Spans "oo 


TEST YOUR WEB PAGE 


EB Open Internet Explorer 
from the Dock. 


¥4 Type http:/Nocalhost into 
your URL field, and press 
Return. 


Start and end of a row in a table 


Favorites Tools Window Help 


? Autordl 


on a ” 
Re Seere ile ote OL Mae OG 8 tr Mertcahofe Ahan Tipe: 


Your home page appears, 
complete with image and 
link. 


B Clicking the image takes 
you to the Idyll Mountain 
Web site. 
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CREATE A STRUCTURED WEB PAGE 


et 


HTML tags in the proper sequence. While you can 
build a very simple Web page with almost no 
formatting commands, you can add to the functionality of 

your Web page by creating some additional structure. 


Y ou can create a structured Web page by inserting 


One simple but important rule that you must keep in mind 
is that when you use tag pairs, such as <b> and </b>, you 
should use them in conjunction with other tag pairs — such 
as <li> and </1i> — in such a way that one set of tags 
fully encapsulates the other. For example, to create a list 
item that is in bold, you should type <li><b>Last one to 
leave must turn off the coffee pot!</b></li>. While this 
rule is not strictly enforced for all tags, it is generally a good 
rule to follow. 


CREATE A STRUCTURED WEB PAGE 


A well-formed Web page has an overall structure that 
identifies the major portions of the page and follows this 
order of encapsulation: The outermost tags are <html> and 
</html>. Within these tags, you may have a section that 
starts with <head>, ends with </head>, and contains your 
title between <title> and </title> tags. Following the 
head, you may have a body that starts with <body> and 
ends with </body>. You then insert your paragraphs and 
links within the body section. The major sections of a Web 
page therefore follow a pattern as follows: <html>, 
<head>, <title>, </title>, </head>, <body>, 
</body>, and </htm1>. In between these major tags that 
provide the overall structure to your Web page, you insert 
the title, headings, links, and text that define the content as 
well as the look of your Web page. 


Terminal File Edit Scroiiback Font Window Help 


sw/apache/htdocs/index.html ff : 


uf Type sudo pico followed 


24 Type the name of your 
by a space. 


home page, and press Return. 


| This is where I tive! 


File 


Edit 


Terminai 


Scroiiback Font Window Help 


<title>testing my mew site</title> 
L 


testing, testing, 1, 2, three 
<p> 

<img src="images/oldhouse. jpg" width=466 ght=220> 
</html> 


ae Writedut 
Be} Justify 


an Read File @ 
Mm) Where is # 


ae Get Help es Cut Text @@ Cur Pos 
my Exit 


gy UnCut Text@ To Speli 


EJ Type <title>testing my new 
site</title> and press Return. 


A) Type </head> and press 
Return. 


B Pico opens and displays 
your home page. 


Position your cursor at the 
end of the first line, and press 


Return. 
ay i The text that you type 


between the title tags 
appears at the top of 
browser windows. 


Type <head> and press 
Return. 


SERVE WEB PAGES WITH APACHE 


The structure of an HTML table follows a pattern that resembles the 
structure of an HTML document. That is, it begins with an opening 
<table> tag and ends with a closing </table> tag. Between these 
two tags, your browser identifies rows between <tr> and </tr> and 
cells between <td> and </td>. The tags <th> and </th> are used 
for column headings. 


Example: 
<table> 
<tr> 
<th>Item</th> 
<th>Price</th> 
</tr> 
<tr> 
<td>pizza</td> 
<td>$li</td> 
</tr> 
<tr> 
<td>salad</td> 
<td>$4.50</td> 
</tr> 


</table> 


File Edit Scroiiback Font Window Help : 4 S Explorer File ids View Go Favorites Tools Window Help 


<head> 
<titlestesting my new site</title> 
</head> 


testing, testing, 1, 2, three 


aes» | Th 
@ | This is where I livei 


<img src="images/oldhouse. jpg” width=400 height=22@>| | 


this is a test 


testing, testing, 1, 2, three 


this is a rest 


This is where | live! 


.) testing 


Show tn Finder 
Quit 


Exit Justify Where is [Rj Next Pg UnCut Te To Spell 4 


Get Help Writedut Read File fj Prev Pg R Cut Text £ Cur Pos 
ij x 


i Type <body> and press &:} Type </body>. EE] Open Internet Explorer @ The browser displays your 
turn. t : i 

Return A svesvourtexayana Sat from the Dock ie page cae su page 

=i Position your cursor at the —_— Pico. Type http:/ocalhost/ ; 

end of the text on the line index.html in your URL field, 


M@ Pico saves your HTML file 


starting with <img and : 
6 = with your changes. 


press Return. 


and press Return. 


239 


ADD SIMPLE STYLES TO YOUR WEB SITE 


more interesting and uniform look. The Cascading 

Style Sheets (CSS) model allows you to define styles 
within or independent of your Web pages, and to apply 
these styles to your Web pages in conjunction with HTML 
formatting. 


Y ou can add simple styles to give your Web pages a 


A style is simply a rule that associates display properties — 
such as bold and blue — with a particular HTML tag. The 

simplest way to define an internal style is to insert the style 
definition into your document. For example, to specify that 
a single heading is to be both bold and blue, you can type. 


<h2 style="color: blue; font-style=bold">From Birth Until 
Now</h2>. 


This style only applies to the text between the <h2> and 
</h2> tags. 


To force all of your <h2> level headings to be bold and 
blue, you can type the command h2{font-weight: bold; 
color: blue;} within the head of your document. 


You can also define in one centralized file, or external style 
sheet, the formatting and layout for multiple Web pages. 
This approach allows you to apply consistent styles without 
having to recreate them in every page. In addition, if you 
need to make a change in the overall style of your Web site, 
you only need to change one file. 


To create a separate style sheet, you must create a file that 
contains the style definitions that you want to use. You 
identify this file with the extension .css. A CSS file contains 
style definitions such as the following: 


black; } 
blue; } 


hi{font-weight: color: 


h2{font-weight: 


bold; 


bolid-=color: 


You can then use a link or an @import command to use 
your cascading style sheet in your Web pages. 


ADD SIMPLE STYLES TO YOUR WEB SITE 


@ Terminal File Edit  Scrollback 


Font Window Help 


<«htmb> 
<head> 
<titleoMy Life story in 5@ words or Less</title> 


<h2>This is my story</h2> 

I was born a long time ago, moved aroknd p Tot, and eventually 
bumped into myself. Isn*t it often Llke Fhat? 

</rtmi{] 


ge Get Help @@ WriteOut Read Filemal 
me Exit ge) Justify Where is Gad 


Ml Cut Text i Cur Pos 


as UnCut Texil To Spell 


USE AN INTERNAL STYLE SHEET | §&¥ Type <! and press Return, 
then type /* H2 headings are 
bold and blue */ and press 
Return again. Then type 
h2{font-weight: bold; color: 


blue;} and press Return. 


ER Type sudo pico followed 
by the name of an existing 
Web page, press Return. 


FJ Press Return and type 
<style type="text/css">, and 
press Return again. 


ee 240 | 


EY Type --> and press Return, 
then type </style>. 


e Explorer File View Go Favorites Tools Window Help 


Back Forward = 3:07 : Prine 


=] This is my story 


=| | was born a jong time ago. moved around a lot, and evetually bumped into myself. Isn't it 
“1 often that way? 


5 | Save your text, and exit 
Pico. 


WA Type file:/Aocalhost/ 
mystory.html in your URL 


field, and press Return. 
6 | Open Internet Explorer 
from the Dock. The browser displays your 
home page with the first 


heading in a bold, blue font. 


Terminat 


{ferro:~] user¥|{sude mv styles.css /sw/apache/htdocs 


Password: 
[ferro:~] user® [] 


When you use an external style sheet, it is far 
easier to maintain a collection of pages in the 


external style sheet called styles.css, you can 


each Web page: 


Example: 


<head> 

<title>life story</title> 

<link rel=stylesheet type="text/css" 
href="styles.css"> 

</head> 


the following: 


Example: 


<head> 
<title>life story</title> 
<style> 

<!— 

@import url(styles.css); 

_> 
</style> 
</head> 


File Edit Seraliback Fant Window Help 


SS TTR eee TS i 


SESE YN AER 


OO SRERIEING Er RY Wolemprare MBB RICYaren OAR NOE. 


same format. To use the Link command with an 


enter similiar text after the opening HTML tag in 


To access the same external style sheet using the 
@import command, you can enter text similar to 


SERVE WEB PAGES WITH APACHE 


While using an internal style sheet may seem to be 
the easiest approach, you must define the style in 
every document you create, and you save little time 
and effort if you only use the style once. You place 
an internal style sheet in the head section of a 
document. 


Example: 
<head> 


<title>My life story in 50 words or 
less</title> 


<style type="text/css"> 
SH 
/* H2 headings are bold and blue */ 
h2{font-weight: bold; color: blue;} 
—_—> 
</style> 


</head> 


Terminal File Edit Scrollback Font Window Hei 


<title>My life story in 5@ words or Less</titlea[] 


H<link relestylesheet type="text/css” 
href="styles .css"> 


<h2>This is my story</h2> 

I was born a long time ago, moved around p lot, and eventually 
bumped into myself. Isn't it often Like Ehat? 

</html> 


Lwore ie lnss | 
Read File Prkv Pg GM cut oe Cur Pos 


@ Get Help BW Writedut 
Mm Exit my Justify Where is BR Next Pg @& UnCut Te To Spell 


USE AN EXTERNAL STYLE SHEET 


LA Type echo "h1{font-weight: 
bold; color: black;}" > 
styles.css and press Return. 


74 Type echo "h2{font-weight: 
bold; color: blue;}" >> 
styles.css and press Return. 


<j Type sudo mv styles.css 
/sw/apache/htdocs and press 
Return. 


E43 enter your password if 
prompted. 


Start Pico using sudo to 
edit an existing Web page. 


Press Return and 
type <link rel=stylesheet 
type="text/css" and press 
Return again. 


RA Press the Spacebar 
four times, then type 
href="styles.css">. 


8 | Save your text, and exit 
Pico. 


@ Your document now uses 
styles that you defined in 


your styles.css file. 244 


| INSTALL CGI SCRIPTS 


ou can install Common Gateway Interface, or CGI, 
Y scripts to make your Web site interactive. CGls 

enable your Web pages to exchange information with 
other programs running on your system. Many CGI 
programs collect information from visitors to your Web site, 
usually through a form, and pass that information to a 
program that processes the data. Other CGI programs 
simply collect data and display it. 


You can find many CGI programs on the Web and install 
them on your system. These programs can include counters 
that increment each time a new client visits your site, and 
forms that allow your visitors to sign a guest book. 


To use CGls on your Web site, you must enable them in 
your httpd.conf file, and you must store them in the proper 
directory. CGls normally reside in the cgi-bin directory, 
most likely /sw/apache/cgi-bin on your system. 


[ @ Terminal File Edit Seroliback Font Window Help re 
[ferro:~] user® /sw/apache/cont/httpd. con 


SeriptAlias /cgi-bin sw/apache/cgi-bin/" 


{ferro:~] usere[sudo pico /sw/apache/cgi-bin/mycgl .p 


Ll Type grep followed by a 
space. 


The output should display 
a line showing you where 


PY Type ScriptAlias followed CGI scripts should reside. 
by a space. Ea Type sudo pico 
/sw/apache/cgi-bin/mycgi.pl 


d R : 
/sw/apache/cont/httpd.conf and and press Keturn 


press Return. 


You must set CGI programs to be executable before you 
can run them from your Web site. This means that they 
must have execute permission enabled so that anyone can 
execute them. You can add Execute permission using the 
chmod a+x command. 


Programmers usually write CGls in Perl, because Perl is one 
of the most versatile and popular programming languages. 
You can, however, write CGls using many different 
languages. 


There are many Web sites from which you can download 
pre-existing CGI scripts. You can also create your own CGI 
scripts; there are many books and Web sites that can teach 
you what you need to know to code in Per! and to build 
effective CGls. An excellent book is Perl: Your visual 
blueprint for building Perl scripts, by Paul Whitehead, 
Wiley Publishing. You can also find a Web tutorial at 
www.cgil01.com/class/. 


Terminal File Edit Scroliback font Window Help 


MOI ie a, 


use que Standard); 

print header; 

print start _htm is is @ 
$greet="Thanks for visiting”; 


print h1 
print hr; 


greet”); 


print end_htat;[] 


Get Help f@ WriteQut 
Exit y Justi fy 


Read File [i Prev Pg | Cut Text £ Cur Pos 


Where is # t Pg UnCut Tex’ To Speli 


w4 Type print start_html("this 
is a CGI"); and press Return, 
then type $greet="Thanks for 
visiting"; and press Return 
twice. 


Type #!/ust/bin/perl -w 
and press Return twice. 


Type use CGI 
qw(:standard); and press 
Return, then type print 
header; and press Return 
again. 


tJ) Type print h1("$greet"); 

and press Return, type print 
hr; and press Return twice, 
and then type print 


es 22 __end htmi:.  ———“—i‘(CC—Cs 


SERVE WEB PAGES WITH APACHE 


To make use of the Perl CG] module, add the command 
line use CGI. In the following CGI example, this 
command is included with standard options. 


Example: 
#!/usr/bin/perl -w 


use CGI qw(:standard) ; 

print header; 

print start_html("this is a CGI"); 
$greet="Thanks for visiting"; 
print hi("Sgreet"); 

print hs; 

print end_html; 


Most of the print lines in this simple CGI script are 
actually calls to the CGI module. When you type print 
header, for example, a routine in the module composes 
a proper HTML header. When you type print h1 and 
include a text message or a string variable inside 
parentheses, another module composes HTML code 
for a level-1 HTML heading. 


[ss 


Password: 
[ferro:cgi-bin] user® [] 


eam > 


E] save your file, and exit 
Pico. 


@ Pico saves your CGI. 


@ Terminal file Edit Scroliback Font Window Help 


wh ita iuat plug lable kemuasalloace ieee MoT mee OT |, Ree rier tr 
[ferra:cgi-bin] user% |sudo chmod a+x_/sw/apache/cgi-bin/mycgi pt 
— 


€ Explorer file View Go favorites Tools Window Help 


SEM 


“y SRST ROMS pa RA At aN NR ARAM AR Me MA HIRES ABNORM RA NOR OOP RAE 
Pe 


omgdyng \ agnemag “\ Assicay “), eeopeenrg |. 
J ; 


ee 


uy) Type sudo chmod a+x 12] Open Internet Explorer in Your new CGI runs and 
/sw/apache/cgi-bin/mycgi.p! the Dock. displays the output. 
and press Return. 


Type http:/Aocalhost/cgi- 


uu] If a prompt appears, type —_ bin/mycgi2.pl into the URL 
your password. field, and press Return. 


INSTALL APACHE MODULES 


modules to expand the capabilities of your Apache 

server. While the default Apache installation sets up a 
very adequate and responsive Web server, the default set of 
modules that are included may not meet all of your needs. 
You can obtain a list of the modules that your installation of 
Apache already supports by typing httpd -1. 


Yo can download and install additional Apache 


To upgrade your Apache server to include additional 
modules, you must download the new modules. If your 
Apache installation includes the mod_so module, you can 
install additional modules without having to recompile 
Apache. This is normal with recent installations of Apache. 
The mod_so module provides Apache with support for 
dynamic shared objects (DSO). This means that you can use 
an external module without changing Apache itself — that 
is, without having to recompile. DSO modules load when 
Apache starts up. 


After you compile a module into a DSO, you can use the 
LoadModule command that is part of the mod_so module 
in your httpd.conf file. This causes the module to load when 
you start or restart Apache. The exact line that you enter 
depends on the module that you are installing. The 
instructions that you obtain with the module, often found in 
a file called README or INSTALL, tell you which line to enter. 


To build a module into your Apache binary, you need to 
download the module, install the files into the modules 
directory for your Apache distribution, and recompile. 
Again, the exact process depends on the module that you 
are installing. Read the README and INSTALL files for 
Apache and the module that you are installing. 


Fortunately, the Apache Web site offers a list of modules 
along with a description of each one. This information helps 
you to find a module that can add the functionality that you 
require. 


INSTALL APACHE MODULES 
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Eu Open Internet Explorer 
from the Dock. 


@ The browser takes you to 
the Apache site to search for 


6" dules. 
4 Type http://modules. ali 


apache.org/ in your URL 
field, and press Return. 


Raabe NA Bhs Assoc iNnt sa At: 


| Click search for modules. 


Exptorer file Edit View Go es Tools Window Help 
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4a Q fh 


Back Forwetd Sten Refresh Home ~< AutoFill Print Mail 


Uc asccail (2) http ://modules.apache org/search ie 


download aa 4 
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Input your search parameters below. You may separate keywords with the * 
boolean conditionals AND and OR to contro! your search results, Search — 
without parameters to view a complete listing of the database. 


4 Type your search term. 


Most, if not all, Apache modules arrive as 
gzipped TAR files. This means that you must use 
the gunzip and tar -xf commands to extract 
your source files. You must then type cd into the 
target directory and look for a README or 
INSTALL file, which should contain detailed 
instructions for installing the module. 


To install a module using DSO, you follow 
directions similar to these: 


Example: 

$ ./configure -with-apxs 
S$ make 

$ make install 
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SERVE WEB PAGES WITH APACHE 


Most Apache modules contain fairly detailed 
instructions that tell you the commands you must 
type to install your new module. 


If you install modules using the dynamic method, 
you must confirm that your Apache daemon 
supports mod_so; to do this, type the command 
httpd -1 and look for mod_so in the output. If you 
prefer the static method, whereby the new module 
is built into your apache binary, or if your Apache 
daemon does not support DSO, you must first 
compile the new module, then follow instructions 
to move the compiled files into your Apache source 
tree, and then recompile Apache. 


View Go Favorites Tools Window Hel 


; 
Forward Stop = Refresh = Heme Aveerilb Prine 


open source _ 
st 26th, 199 


E¥ Scroll through the list of [J Click the module you Bi The download page w4 Click the link provided to 
modules containing your want to download. appears. download your module. 


search string. 


WRITE PHP APPLICATIONS 


site. PHP is a relatively new language that integrates 

easily with the Apache Web server. When you can 
code in PHP, you can dramatically reduce the time that it 
takes for you to develop Web applications. In order to use 
PHP, your Apache binary must support it. 


Y ou can develop PHP applications for use in your Web 


To understand the similarities between PHP and HTML, you 
have only to look at some sample code. For example, to 
print a variable on a Web page, PHP mimics the style of 
HTML commands while using special tags that only belong 
to PHP: 


<html> 
<head><title>Latest Counts</title></head> 
<body><?php echo S$grplcnt<br>; ?></body> 
</html> 


PHP files do not need to be executable, and the output 
appears indistinguishable from HTML. 


WRITE PHP APPLICATIONS 


Terminal File Edit Scroiiback Font Window Help 


TEST PHP 


4) Type /sw/apache/htdocs 
/testme.php and press Return. 


ull Type sudo pico followed 
by a space. 


> 


u {ferro:~] user% {] 
Type <html> and 
press Return, then type 
<title>testing</title> and 
press Return again. 
Type <body> and press 


You must always enclose PHP scripts between two PHP 
tags. The tag pairs can be in one of several forms, such as 
<? and ?> or <?php and php?>, although some 
programmers use <?php and ?>. 


PHP uses many commands, including printing, looping, if 
commands, arrays, and forms, but if you are already familiar 
with HTML, you should grasp the fundamentals of PHP 
quite easily. 


PHP is a server-side scripting language. This means that the 
interpreter has to be installed and configured on the server 
before it can be used. No special client-side setup is 
required. The language combines features from Perl, Java, 
and C, so most people who have programmed in any of 
these languages will feel at home with PHP. 


All text to be written to the screen must be enclosed in 
double-quotes and almost all commands will end in a 
semicolon. Pages containing PHP commands should be 
saved with the extension .php. 


Terminal File Edit Scroilback Font Window Help 


| <oO0dy> 


<?php phpinfoQ); ?> 


</body> 
</html> 


EJ Type </body> and press 
Return, then type </htmb>. 


GF save your text, and exit 
Pico. 


Return, then type <?php 
phpinfo(); #> and press 
Return again. 


SBOE LOT? 


Open Internet Explorer in 


the Dock. 


Type http:/Nocalhost/ 
testme.php in your URL 
field, and press Return. 


Rateeckh = pat 


You can mix PHP and HTML easily in a single file. 
When you do so, you enclose each of your PHP 
statements in a pair of PHP tags, as in the sample 
below: 


Example: 

<?php $season="summer"; ?> 

We are now accepting reservations for our 
<?php print $season season; ?> 

Call 1-800-FUN-VACS today. 


This code segment assigns a value to $season 
and then uses this value to customize the 
content of the remainder of the display. In a 
similar manner to Perl, PHP allows you to create 
simple data types, like $season, and arrays in 
which you can use both a variable name and an 
index, such as $season[1]. 


<? php 

$times=11) 

$x=0; 

while ($x < $times) f 


echo “Hello, World"; 
++5x 


@ The browser displays a CREATE A PHP 
page of information about 
PHP if your PHP installation 


is active. 


name hello.php. 


Terminal File Edit 


[ferro:~/project_Xx] users [] 
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OPERATOR 


Basic comparison operators include all 
those listed in the table below. 


DESCRIPTION 


eq 


Seroliback 


Oo Start Pico to create a file 


74) Type <? php and press 
Return, type $times=11; and 


press Return again, and then 
type $x=0; and press Return 


twice. 


Font Window Help Rhy 


i 

H 

H 
ial - 

a 


< Type while ($x < $times) { 
and press Return, type echo 
"Hello, World"; and press 
Return again, and then type 
++$x; and press Return. 


C3 Type } and press Return, 
then type ?>. 


5 | Save your file. 247 
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ANALYZE WEB TRAFFIC 


Analog. Analog is a free, open source program that 

you Can use to analyze Web traffic based on records 
stored in your log files. Analog can produce as many as 32 
different reports. For example, it can provide you with 
charts that highlight heavy traffic times — for instance, 
times of the day or days of the week. It can also show you 
which of your files visitors access most frequently, which 
files are not found, or where visitors are coming from when 
they follow links to your Web site. 


Y« can analyze your Web traffic using a tool called 


Analog has a configuration file, called analog.cfg. Fink 
installs this file into the /sw/etc/analog directory. Like most 
configuration files, analog.cfg is full of helpful comments, 
and has a number of configuration options. The most 
important of these options is the line that identifies where 


ANALYZE WEB TRAFFIC 


& Terminal File Edit Scroilback Font Window Help — 


arts 1.1.8-3 KOE ~ anutog reditime synthesizer 
[ferro:screenshots} user% [] 


CHECK IF ANALOG IS INSTALLED BB Fink tells you whether you 


TH Type fink list | followed by | have installed analog. 


a space. A lowercase letter i in the 


leftmost column indicates 


2 
zal Type grep analog and that Fink is installed. 


press Return. 
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you store your Web log files. If you store your Web logs in 
/sw/apache/logs, you must change the line that starts with 
LOGFILE to read LOGFILE /sw/apache/logs/access_log. If 
you do not have the correct log file location, Analog cannot 
analyze your Web traffic. 


Analog analyzes Web traffic by individual file requests, as 
this is the manner in which your system records Web traffic 
in your log files. Traffic can be reported hourly, daily, 
weekly, or monthly by turning report options on and off. 
For example, to turn monthly reports off, you can add 
MONTHLY OFF to your configuration file. To turn weekly 
reports on, you can add WEEKLY ON. To produce one of 
the many types of reports available from Analog, you can 
scan a list of the available reports and insert commands 
such as REFERRER ON in your configuration file. 


& Terminal File Edit Scroilback Font Window Help 


# Lines starting with # are comments. 

# 

# There is a much more extensive configuration file in examples/big.cfg 
# 


# If you need a LOGFORMAT command (most people don‘t -- try it without first$ 
# it must go here, above the LOGFILE commands. 
# LOGFILE po phen Log 


| LOGFILE] /sw/a ocke/leus/occess. = 


OUTFILE /sw/apache/htdocs/analog@. htm 
PNGIMAGES ON 


MONTHLY OFF 
Default Location on Mac OS X ~-cp 


# 
DNS READ 
# ONS lookups turned off to avoid an apa 


t bug in Mac OS X. --cp 


Bd Get Heip JP Writedut J) Read Filef Ba cut Text JB cur Pos 
Bs Exit m) Justify fj Where is # a Uncut Texfj To Spelt 


CONFIGURE ANALOG <3) Type OUTPUT HTML and 


press Return. 


=a) Type OUTFILE /sw/apache/ 
htdocs/analog0.html and press 
Return. 


LB Start Pico with sudo to edit 
/sw/etc/analog/analog.cfg. 


#4 Change the LOGFILE line 
to include the pathname of 
your access_log, and press 
Return. 


SERVE WEB PAGES WITH APACHE 


Until you start to use the reports that Analog produces, you may not know which 
reports are the most useful to you in analyzing your log files. In addition, your 
requirements may change over time. The following table describes some of the 
reports available to you. To include any of these reports in your Analog output, 
insert the keyword, then the word ON, into your analog.cfg file. 


REPORT DESCRIPTION 


MONTHLY 
WEEKLY 
REQUEST 


STATUS 


Scroilback Font c Terminal file dit Scroilback Font Window Help 


f /sw/bin/analog: analog version 5.24/68 X 
PNGIMAGES ON [ /sw/bdin/analog: Warning R: Turning off empty Search Word Report 
MONTHLY OFF : (For help on all errors and warnings, see docs/errors .html) 


t Default Location on Mac OS X ~-cp /sw/bin/analog: Warring R: i pty Operating System Report 


DNS READ 
# DNS lookups turned off to avoid an apparent bug in Mac OS X. --cp 
& 


CASE INSENSITIVE \ —_— «= 
# The default file system in Mac OS X is HFS, which is case insensitive. Back  forwerd Sten? ,.. eS Aufofil Print 


HOSTNAME “Dragonfly Ditch” 


WH REQINCLUDE pages ig 
REQLINKINCLUDE pages : i 
REFLINKINCLUDE * ie i 3a Mi sa 
REDIRREFLINKINCLUDE * i 2) BE] Web Server Stat 
FAILREFLINKINCLUDE * i i . 

UNCOMPRESS *.gz,*.2 “gzip -cd” | Ditech 

SUBBROW */* i ; 


Get Hel Writedut Read File [MY Prev Pg Cut Text Cur Pos | | Program started at Thu-22-May-2003 16:57. 
Ee me. & Justify are cts a Next Pg aan Text] To Spell 74 Analysed requests from Tue-20-May-1997 07:28 to Thu-22-May-2003 16:00 (2193.36 


days). 


= Type HOSTNAME Mi Pico saves your changes to | RUNANALOG K Type /sw/apache/htdocs/ 
mt H q 1 

Dragonfly Ditch". the analog.conf file. El Type /sw/bin/analog and a and press 
[save your text, and exit press Return. ; 
Pico. @ Your Analog report 


74 Type open followed by a 


space. displays in a browser 


window. 


WRITE A SIMPLE PERL SCRIPT 


require compiling. Perl is an interpreted language. 

However, Perl looks like a compiled language in a 
number of ways. For example, each statement in Perl ends 
in a semicolon, and a $ symbol precedes variable names, 
even when you first declare them and assign them a value. 
More importantly, Perl allows you to build subroutines, pass 
variables, and return values like most compiled languages. 
Perl also has sophisticated array handling. 


Y: can use Perl to write a simple script that does not 


However, the feature that most distinguishes Perl from 
other languages is the versatile use of regular expressions. If 
your only experience with regular expressions comes from 
working in one of the Unix shells, you may be amazed at 
the versatility of the Perl language. For example, you can 
use regular expressions in Perl to do fuzzy matching. With 
fuzzy matching, instead of asking whether one number is 


WRITE A SIMPLE PERL SCRIPT 


Terminal File Edit Scroliback font Window Help 


Sao e evi: 
{[pico] san. i] 


4 Type sam.pl and press 
Return. 


ull Type pico followed by a 
space. 


A blank Pico screen 
appears. 


greater than another, or looking for a number in a string, 
you can ask if a line of text contains an e-mail address or a 
date/time stamp by describing these items as patterns. 


Although the use of regular expressions can make Perl code 
difficult to interpret at first, when you become more 
familiar with each of the symbols, you can begin to 
appreciate the succinct form of the language. 


The elements of a Perl pattern are referred to as 
metacharacters. For example, \s represents a single 
whitespace character — a blank or a tab — and \S 
represents any non-whitespace character. You can also 
amend these patterns to match some or none or a string of 
any size. Where \d represents a digit, \d+ represents any 
number of digits and \d* represents any number of digits, 
but will also match no digits at all. 
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Iprint|“Hello, World -- "; 
L 


ae Get Help Writedut Read File Prev Pg Cut Text Cur Pos 
a Exit Justify 


Where is Next Pg UnCut Text#ij To Spell 


4 Type "Hello, World -- "; 
and press Return. 


Type print followed by a 
space. 


As with most Unix scripting languages and 
configuration files, you create a comment in Perl 
by placing a # symbol at the beginning of the 
line. You can place a comment on a line by itself 
or append it to the end of a line of code. Either 
of these forms is correct: 


Example: 
# say hello 


print "Hello, World - "; # say hello 


When you create a complex script, you should 
include some comments that explain what your 
script is doing, but avoid superfluous comments 
that may annoy someone who reads your code. 
In Perl, comments are often used to explain 
complex regular expressions. 


WORK WITH PERL 


The "\n" shown in the screens below indicates a 
newline character. If this character were omitted 
from our print statement, the script would print the 
output without moving to the new line, and the next 
system prompt would be on the same line. You 
usually include newline characters in the print 
statements along with text that you want to print. 
For example, you can type the line print "Hello, 
World\n"; in a Perl script to print the message and 
move to the next line. 


@ Terminal File Edit Scroilback font Window Heip 
at 2 : “" may 


me Get Help 8 WriteOut Read File #4 Prev Pg iM Cut Text Cur Pos 
By Exit Me) Justify Where is [BY Next Pg § UnCut Tex To Spell 


Type print followed by a 
space. 


Li Type "lam $0"; and press 
Return. 


Type print followed by a 
space. 


Type "\n"; and press 
Return. 
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print “Hello, World -- ”; 
print “I am $8"; 


fferro:~/pert] user [] 


E} save your file, and exit 
Pico. 


Pico saves your new Per! 
script. 


RUN A PERL SCRIPT 


the Perl interpreter, or by making it executable. After 

you create a Perl script, you can instruct Perl to 
interpret and execute the script, for example, by typing perl 
myscript.pl. This is the simplest way to run a script, but not 
the most convenient. Most users prefer to run scripts as 
though they are new commands, and without having to 
know anything about the language in which they are 
written. Thus, they may not want to type perl before the 
name of the script. 


Y ou can run a Perl script by using it as an argument to 


For the convenience of users, and to avoid errors that may 
generate if they type the name of the script on a line by 
itself, you can insert a line at the top of the script that 
identifies your file to the shell as a Perl script, and you can 
make the script executable. You refer to this line as the 
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erro;~/perl] user® |pert |sam.pl 
eltc, World -~ I am sam.p 


erro:~/perk] users 


i Type perl followed by a 
space. 


v4, Type sam.pl and press 
Return. 


@ Perl runs your script. 


shebang line, and the syntax for this line is #! followed by 
the name of the interpreter. For a Perl script, you can type 
#!/usr/bin/perl. 


If you make your Perl script executable without the shebang 
line, the system cannot determine what tool to use to run 
the script, and it attempts to run the commands using your 
shell. This action generates a number of errors, as tcsh does 
not include a print command. If you mistype your 
shebang line, your system cannot find the interpreter and 
issues an error such as "not found: myscript.pl". 


You can force yourself to use rules that are more restrictive 
in your Perl coding by adding use strict; to the top of 
your scripts. While adding this to your scripts may generate 
warning messages, these messages may help you avoid 
many potential errors in your code. 


RUN A PERL SCRIPT 
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[ferro:~] user 
[ferro:~} user% 


./sam.pl: print: [command not found 
./san.pl: print:|command not found 
./sam.pl: print: |command not found q 


[ferro:~J users 


Type chmod a+x followed 
by a space. 


Type ./sam.pl and press 
Return. 


The shell cannot run your 
print command. 


Type sam.pl and press 
Return. 


A: Type pico sam.pl and 
press Return. 


WORK WITH PERL 


You can use the command line option -w on the The shebang line tells the shell which language you 
shebang line — by typing #!/usr/bin/perl -w — used to write the script and, consequently, what 

to instruct Perl to issue warnings regarding your tool the shell can use to run the commands. For the 
syntax. For example, if you define a variable, script to run, the shebang line must contain the full 
such as Scounter, and then never use it, Perl path to the Perl interpreter. This is the case whether 
warns you that this variable appears only once in or not the Perl binary is on your search path. Also, 
your code. By doing this, Perl is telling you that this line must be the first line in the script and must 
you have made a mistake or, at least, strayed start with #!. 

from your original intent in writing the script. 


Perl warnings are very useful when you are first 
learning the language, as they can help you to 
spot problems that prevent your script from 
running, or represent poor scripting style. 


Terminat File Edit 


Font Window Help . 
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[Eferro:~/pert] user%] ./sam.p1| 
Hello, World -- I am ./sam.pl 
#t/use/bin/perl Lferro:~/pert] user® || 
print “Hello, World <- 7; 
print “I am $6"; 

print “\n"; 


(ferro:~/perlj] user% {] 


B Pico opens with your file. Ed} Save your file, and exit Type /sam.pl and press Perl runs your script. 


Type halite Pico. Return. 


#!/ust/bin/perl at the top of @ Pico saves your modified 
your script, and press Return. _ script. 


MANIPULATE TEXT WITH PERL 


help you manipulate text. If you are able to describe character. The escape character tells Perl to take the 
a pattern that you are looking for in a stream of text, following character literally and not to interpret it as part of 
then you can represent it as a Perl regular expression with the Perl syntax. Thus, \/ represents / in your search pattern. 


which you can easily extract and manipulate it. 


YY": can use the ability of Perl to recognize patterns to include as characters you want to match with an escape 


Perl has many special character sequences, such as \d, 


For example, if you are looking for dates that look like to help you to locate and manipulate text. Users refer to 
05/01/03, you can tell Perl that you want strings that match these character sequences as metacharacters or escape 

the pattern \d{2}\/\d{2}\/\d{2}. While this expression sequences. Many metacharacters have both a positive and 
may look complicated, a quick breakdown makes it easier negative form. For example, while \d represents a digit, \D 
to understand. The string \d matches a digit, and when represents a non-digit — any character that is not a digit. 
changed to \d{2}, it matches a two-digit number. The date While \s+ represents any amount of whitespace, \S+ 
above includes three of these strings. The two extra forward represents any string of characters that does not contain any 
slashes in the search pattern indicate that the strings you whitespace. The biggest challenge to most Perl beginners is 
are searching for contain slashes. Because slashes are a part to remember what each of the metacharacters represents. 


of the Perl syntax, you must precede any slashes that you 


MANIPULATE TEXT WITH PERL 
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#!/usr/bin/perl -w 
while ( <> ) 

if C /\d{23S/N\d{[23\/\df2}/ ) £ 
L 


mn Get Help M® WriteQut BN Read File e ey Cut Text @@ Cur Pos 
ay Exit Bi Justify jiy Where is me Uncut Tex To Spell 


SEARCH A FILE FOR DATES @ Pico opens so that you can 3 Type while (<>) { and 
ull Type pico finddates.p! and edit your file. he ee os ae 


press Return. Type #!/ust/bin/perl -w press Return 

and press Return twice. ‘ 
EJ] Type print $_; and press 
Return, type } and press 
Return, and then type } 


and press Return. 


WORK WITH PERL 


Perl recognizes many different metacharacters, shows some of the most common metacharacters 
allowing you to closely describe text that you are and what they represent. You can use the + and * 
looking for and to manipulate it. The table below qualifiers with any of the metacharacters. 


METACHARACTER MATCHES METACHARACTER MATCHES 


\d+ ver Some whitespace or no 
, Ww 


A form feed A A word character — a letter, 
A lowercase letter. digit, or underscore 
A newline. \W A non-word character. 


A carriage return. An octal character. 
A whitespace character. A hexadecimal character. 
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{ferro:~/perl] userk|chmod asx |finddates.p1 
ferro:~/perl] userk 
#1/usr/bin/perl -w f 05/01/83 Leave for Quebec 
| 95/11/83 Return via NYC 
while Co) { : 5/12/63 Arrive in DC for briefing 


i i 05/15/03 Back in home office 
a i a ae rf i [ferra:</perl] user% [| 


A Get Help 
Cancel 


Ed Save your file, and exit Type chmod a+x Ld Type the name of a file 
Pico. finddates.pl and press Return. | containing dates, and press 


Type ./finddates. pI Return. 


followed by a space. Your Perl script displays all 
lines that contain dates in the 
specified form. 


READ THE COMMAND LINE 


command line. Like other scripting languages, Perl 

allows you to prompt the user to enter information. 
Perl does this by issuing a print statement containing the 
prompt and then reading the answer from standard input. 
For example, you can include a prompt in the script with 
the line print "Enter your favorite number> "; 
and then collect the answer with $ favnum=<STDIN>;. 
When the script runs, Perl prompts you for the number 
and stores it in $favnum. 


Y ou can build Perl scripts that read data from the 


You can also place your prompt-and-read statement into 

a loop. A while statement continues looping until the 
specified conditions are met. A foreach loop is good to use 
if you want to collect a specific number of answers from the 
user. For example, you can enter the following commands: 


Stothrs=0; 

foreach day ( Mon,Tue,Wed,Thu,Fri ) { 
print "hours worked on Sday> "; 
Shrs = <STDIN>; 
Stothrs = $tothrs + Shrs; 

print "You only worked Stothrs hours!"; 


This script prompts the user to enter the number of 

hours that they work each weekday, and computes a total. 
However, this script generates an error message if the user 
enters anything other than a number, because the addition 
fails. You can insert a while statement inside the foreach 
statement to repeat the prompt until the user enters a 
number. 


@ Terminal File Edit Scrollback 


LE Type pico favnum.pl and 
press Return. 
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#i/usr/bin/perl -w 


print "Enter your favorite number> "; 
$favnunm = <STDIN> ; 
print “What a coincidence! $favnum is 


print “Maybe we should go out.\n";]} 


favorite number too.\n"; 


Get Help 
Exit 


Cur Pos 


me WriteOut By Read Files n 
To Spelt =, 


fei Justify gj Where is @ 


Cut Text 
UnCut Tex! 


Type #!/usr/bin/perl —w 
and press Return twice, then 
type print "Enter your favorite 
number> "; and press Return. 


Type print "What a 
coincidence! $favnum is my 
favorite number too.\n"; and 
press Return. 


Type $favnum = <STDIN>; 
and press Return. 


] Type print "Maybe we 
should go out.\n";. 


WORK WITH PERL 


There are times when you do not want to use data exactly as a user 
enters it. For example, when you tell the user that their favorite number 
just happens to be your favorite number, too, as in the favnum.p1 script, 
your message displays on two lines instead of three. This unintended line 
break results when Perl reads the input line, including the linefeed, and 
retains the linefeed. As a result, when the output displays to the user, the 
linefeed is still present in the $ f£avnum variable. 


You can remove these unwanted linefeeds by using the chomp command. 
The chomp command simply removes the linefeed from the end of the 
line. The format for the chomp command is chomp ($variable). Thus, 
you can add the line chomp ($favnum) ; to the script immediately after 
the line that reads the response from the user. When the chomp 
command removes the linefeed, the output changes to reflect this. 


BEFORE: Ne | AFTER: 


What a coincidence! 111 What a coincidence! 


is my favorite number too. Sage ped 


Maybe we should go out. 


Maybe we should go 
out. 


6 Terminal File Edit Scroliback Font Window Help % 


es ela heat — 


print “Maybe we should go out.\n"; 
#!/usr/bin/perl -w 


print “Enter your favorite number> “; 

$favnum = <STDIN>; 

print “What a coincidence! $favnum is my favorite number too.\n"; 
print “Maybe we should go out.\n"; 


rs 
{ferro:~] user% 
ferro:~] user%|./favnum.pl| 


Enter your favorite number> 111 
What a coincidence! 1112 

File Name fo. Wr is my favorite number too. 
| Get Help gi 


je Cancel {ferro:~} users }| 


=] Type ./favnum.pl and press 
Return. 


£4 Type chmod a+x followed 
by a space. 


3 Save your script, and exit 
Pico. 


3} Type favnum.pi and press The script runs, asking you 
Return. for your favorite number. 


UNIX FOR MAC 


READ FILES WITH PERL 


script. There are also a number of ways to read files in 

Perl, the most straightforward being to use the open 
command with the name of the file as an argument. For 
example, to open the file myfile.txt, you can use the 
command open (INFILE, "myfile.txt") ;. This command 
opens the file and associates it with the file handle INFILE. 
You can also assign the name of the file to a variable 
using a command such as $myfile="/Users/user / 
myfile.txt"; and then open the file with an open 
command such as open (INFILE, $myfile) ;. If you assign 
the filename at the beginning of the script, your script is 
easier to modify later. 


Y ou can read any number of files from within a Perl 


You can also open a file explicitly for reading by using a < 
symbol within your open command. For example, you can 
use the command open (INFILE, "<myfile.txt") ;. This 


READ FILES WITH PERL 
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ill Type pico read1 and press 
Return. 


is good practice if you want to ensure that the files that you 
read are preserved, as it opens the file only for reading, and 
disallows any write operations. 


Just as the < symbol indicates that a command is opening a 
file for reading, the > symbol indicates that a command is 
opening a file for writing. Using the > symbol indicates that 
a command is opening a file for appending. In other words, 
you write from the end of the file, preserving the current 
contents of the file. 


To be sure that your scripts do not malfunction when input 
files do not exist or are unreadable, you can add an or 
die clause to your open command. The command 
open(INFILE, "<myfile.txt") or die "Cannot 
open myfile.txt for reading"; displays the 
cautionary message if the input file is unreadable, and exits 
the script. 
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Get Help 9% WriteOut Me Read Filegs v Pg fBN Cut Text Cur Pos ; 
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Type #!/usr/bin/perl -w 
and press Return twice. 


Type while (<INFILE>) { 
and press Return. 


Ed Press the Spacebar four 
times, type print $_; and 
press Return, and then type }. 


Type open(INFILE, 
"<myfile.txt");, replacing 
myfile.txt with the name of 
your file, and press Return 
twice. 


WORK WITH PERL 


Another way to read files in Perl is to use backticks. For example, 
if you want to read the contents of a file into an array, you can 
use a command such as @lines=*cat myfile.txt* ;. This 
command runs the cat command, collects the output, and stores 
each line in that output as an element in the array @1 ines. While 
this operation is as simple as the more formal open commands, it 
also involves more overhead — especially for very large files — as 
it stores the data it reads into memory. When the operation reads 
a file one record at a time, it stores one record at a time. 


Backticks are a good way to get information from your system. 
For example, if your script needs to use the current date, you can 
assign the date to a variable using a line such as $date=* date 
+%m%d%y~ ;. This command stores a date of the form 05/01/03 to 
the $date variable. You can then use this variable to name output 
files or to add records with a date stamp to a file you are creating. 
For example, you can open an output file with a command such 
as open (OUTFILE, ">myfile.$date");. 
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#!/usr/bin/perl -w 
openCINFILE , “<myfile.txt"); 


while (<INFILE>) { 
print $_; : 
} : ({ferro:~] user% 
: [ferro:~] user%] ./readi| 
Here is the schedule: 


05/81/83 Leave for Quebec 
take photes and manuscript 
drop the cat at the sitter's on the way 
05/11/83 Return via NYC 
stop for meeting in Upper West Side offices 
lunch with Candice and Madeleine 


05/12/03 Arrive in DC for briefing 
Were fu WE ut dd @5/15/@3 Back in home office 
© Get Help send notes to hok@company.com 
Cancel “7 {ferro:~] user% [] 
3] Save your script, and exit Type chmod a+x followed EJ Type /read1 and press 
Pico. by a space. Return. 
Type read1 and press Your script runs, 

Return. displaying each line in 


the file to your screen. 


WRITE FILES WITH PERL 


read files with Perl. In fact, the command for opening 

a file for writing is almost the same as that for 
opening a file for reading. The command open (OUTFILE, 
"smyfile.out") or die "Cannot open myfile.out 
for writing"; attempts to open the specified file for 
writing and exits the script if this cannot be done. Changing 
the > symbol to the >> symbol appends any subsequent 
output to the file instead of overwriting it. 


Y ou can write files with Perl as easily as you can 


After a file is open for writing, you can use the print 
command to write to it. While a command such as print 
"Maybe we should go out\n"; prints to the screen, 
the same line with an additional argument — print 
OUTFILE "Maybe we should go out\n"; — writes 
the line to the output file. 


If you write text that does not contain linefeeds, you will 
not have separate lines in your output file. The print 
operation does not add linefeeds whether it is writing to 
the screen or to a file. 


When you are finished writing to a file or reading from a file, 
you can close the file. The close command is very similar 
to the open command except that you only need to use the 
file handle, and you do not need to specify the filename. For 
example, if you want to close the file associated with the file 
handle OUTFILE, you type the command close OUTFILE; 
and the file closes and is no longer available for reading. 


If you are creating a temporary file and you want to remove 
it when you finish with it, you can use the unlink 
command in place of the close command. The unlink 
command removes the file from the file system. 


user®|pico write |] 


openCINFILE , "<myfile.txt"); 
open(QUTFILE, “>myFile out"); 


; #i/usr/bin/perl -w 

$counter=0; 

while (<INFILE>) { 
$counter-++; 


print OUTFILE "$counter: 
} 


([ferro:~/pert] user® [] 


LJ Type while (<INFILE>) { 
and press Return, type 
$counter++; and press 

Return again, then type print 
OUTFILE "$counter: $_"; and 
press Return, and then type }. 


ul Type pico write1 and press 
Return. 


Z4| Type #!/usr/bin/perl —-w 
and press Return twice. 


EJ] Type open(INFILE, "<my 
file.txt"); and press Return, 
then type open(OUTFILE, 
">myfile.out"); and press 
Return twice, then type 
$counter=0; and press 
Return twice. 


260 


EA save your script, and exit 
Pico. 
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[ferro:~/pert] user® 

[ferro:~/perl] user% 

[ferro:~/perl] usSer® 1s -1 myfile* 

~rw-r--r-- 1 user staff 316 May 21 88:55 myfile 


-Paer--r-- louser staff 316 Moy 21 14:46 myfile.txt 
[ferro:~/perl] user® 


E} Type write and press 
Return. 


Type chmod a+x followed 
by a space. 


Type write1 and press 
Return. 


Your script runs, creating 
the output file. 


WORK WITH PERL 


One of the advantages of using Perl For readability, your file handles should be 


over other scripting languages is that meaningful. If you use a temporary file, calling it 
it allows you to read and write any TMP or TMP1 makes it clear to anyone reading 
number of files at the same time. your code that you do not intend to preserve the 
For each file that you want to use, file. If you use temporary files, you must always 
you type an open command, specify remember to unlink them when you are done; 
the filename, indicate whether you otherwise, your script may not run the next time 
are opening the file for reading, you try to use it because it may not be able to 
writing, appending, or both reading open a file that already exists. In addition, scripts 
and writing, assign a file handle, and that leave unnecessary files behind when they 
write records to the file. When you finish running create clutter in your file system. : 
are done, you type a close or an Giving temporary files random names, such as 
unlink command. myfile$$, reduces conflict over filenames. 


| @& Terminal File Edit Scroilback Font Window Help Terminal file Edit Scroliback font Window Help 
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user%|pico hrs| $tothrs = Stothrs + $hrs; 
open(L0G,">>$10g"); 
print LOG "$dete: $tothrs hours\n"; 


$log="time. log"; close LOG; 


$date«'date +Xykntd”; chomp($date); 
$tothrs=0; 


foreach $day ( Mon,Tue,Wed,Thu,Fri } { > 
print “hours worked on $day> “; 
$hrs = <STDIN>; 
$tothrs = $tothrs + $hrs: 


930625: 56 hours 
tferro:~] users [] 


LB Type pico hrs2 and press <4 Type foreach $day ( Ji Type open(LOG,">>$log); 4 Type a number, and press 


Return. Mon, Tue, Wed, Thu, Fri) { and and press Return, then type Return for each prompt. 

; a ; press Return, and then type print LOG "$date: $tothrs . 

2 ee ee ae print "hours worked on $day> | hours\n"; and press Return S ih a cat time.log and 
erie pean soy" ae "; and press Return again. again, and then type close Poreernar 

= ‘oY /o' oG >; ae a f Si . 

chomp($date); and press Type $hrs = <STDIN>; il ai ata by Your script etl al oa 
Return, and then type and press Return, then type Type perl hrs2 and press REA ee Mone OEBE S1B> 
$tothrs=0; and press $tothrs = $tothrs + $hrs; and Return. @ Your log file appears. 
Return twice. press Return again, and then 


type } and press Return again. 


INSTALL PERL MODULES 


erl modules are collections of reusable code that can 

make your Per! programs more powerful and easier 

to maintain by downloading and installing Perl 
modules. Perl modules are meant to be used in other 
programs using statements such as use Net: : Telnet; that 
make these procedures accessible in your own Perl scripts. 
Perl modules are well designed and well documented and 
can save you a lot of programming effort. 


The best place to begin your search for a Perl module that 
meets your needs is search.cpan.org. When you go to this 
site, you can enter a name into the search field if you know 
the name of the module that you want or you can search by 
category. 


In the process of downloading your module, you should 
take advantage of the online documentation available for 
your module. This documentation will provide instructions 


and examples of how the module can be used. After you 
click on the link that takes you to the page describing the 
module you want, you can scroll down the page to find a 
description of the module along with information on usage, 
debugging, parameters, and more. 


There are many Perl libraries and modules already installed 
on your system. You can list the installed modules with the 
command find/System/LibraryPerl -name "*.pm" 
-print. This directory even includes a module for making 
the process of downloading other Perl modules from CPAN 
even easier. You can look at CPAM.pm or read about this on 
the CPAN Web site to find out more. 
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“4 Enter the name of a Per! 
module, such as Net:: Telnet, 
in the search window and 
click CPAN Search. 


WORK WITH PERL 


Before you can use a Perl module in your script, You must use the package command to 


you must load it with the use command. The create Perl modules, and you must organize 
command use diagnostics; loads the module | them as subroutines, and name them with the 
diagnostics.pm from your /System/Library/Perl file extension .pm. Construction of a module 
directory. The command use Net: :Telnet; also requires the use of commands to export 
loads /System/Library/Perl/Net/Telnet.pm. items that you create in the module. For more 


information about creating Perl modules, you 
can consult Perl: Your visual blueprint for 
building Perl scripts, by Paul Whitehead. 


You can also build your own Perl modules. If you 
develop Perl code that may be used in many 
scripts or by many users, you may want to turn 
the reusable code into a module and install it 
into the /System/Library/Perl directory. 
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we internet zone 


@ Your search results appear. —_Note: You may have to scroll down to “#4 Scroll down the page to & Right-click the Source link 
ee find your match. read about the module, or in the page. 

, print this page for later 
more than one matches your rererence: 


request. 
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INSTALL PERL MODULES (CONTINUED) 


ou can install Perl modules to increase your 

productivity as a Perl programmer. There are many 

Perl modules that you can download and install to 
increase the sophistication of your Perl scripts. Each Perl 
module contains a number of routines that are relevant to a 
particular type of processing. For example, the CGI module 
reduces the code that you must produce to create CGI 
scripts. Most modules are free, and you can modify them, if 
needed, to suit your application. Modules are contributed 
by their authors who consider them useful enough to be 
generally valuable. If you are now or become a proficient 
Perl programmer, you might consider contributing modules 
that you develop to the Perl community. 


You may sometime acquire a Perl modules in the form of a 
gzipped TAR file. When this is the case, the process of 
installing looks much like the process of compiling open 


INSTALL PERL MODULES (CONTINUED) 


w Go Favorites Tools Window Heip 


source software from the same kind of file. However, 
because Perl is not compiled, the make step will not result 
in a compilation. The steps for installing a Perl module 
packaged as a tar.gz file are as follows: 


gzip <module-name.tar.gz> 
tar xf <module-name.tar> 
cd <module-name> 

perl Makefile.PL 

make 

make test 

make install 


Some Perl modules will require other modules to be installed 
before they can be used. When a module that you are trying 

to install has a prerequisite, you will get a message when you 
type the perl Makefile.PL command. 
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L@ Click the Save button after 
verifying your save location. 


@ The Save dialog box 
appears. 


WORK WITH PERL 


A pragma is a special Perl module that comes with your 
installation of Perl. If you have tried the use strict; 

command, you have already used one of these special modules. 
You can learn more about the pragmas that are included in your 
release of Perl with the command man perlmod1ib. 


If you are interested in the format 
and other technical details of how 

Perl modules are organized, the Perl 
mod man page will provide you with 
many insights. In a Terminal window, 
type man perlmod and press Return. 


Perl has a search path that it uses to look for modules. You 
can view this by issuing the perl -e ‘print "@INC"' 


command as shown here. 
RESULT: 


/System/Library/Perl/darwin 
/System/Library/Perl 
/Library/Perl/darwin 
/Library/Perl /Library/Perl 
/Network/Library/Perl/darwin 
/Network/Library/Perl 
/Network/Library/Perl 

, [ferro:~] user% 


{ferro:~] user% perl -e 
‘print, "GENC"’ 


Explorer File Edit View Go Favorites Tools Window  Heip % Terminal File Edit Scroilback Font Window Help 
toe § Telnet.pm /System/Library/Perl/Net 
Buk Forwwd Stop Retvesh Wome | Autor 


ht Reet 


SS Apple Siang 23 Bouts 


Home Author 


12 Minutes 
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NAME 

SYNOPSIS 

DESCRIPTION 
What Ts Know Before Using 
Debugging 
Style of Named Parameters 


The download manager 
downloads your module. 


In a Terminal window, 
type sudo cp Telnet.pm 
/System/Library/Perl/Net 
or copy your Per] module 
to the proper location in 
/System/Library/Perl using 
the name of the module 
to determine if the library 
belongs in a directory. 


E) Press Return. 


iY Enter your password if 
prompted. 


WRITE A CGI SCRIPT 


Y« can write a CGI script to create a Web page that The CGI module uses functions to generate HTML code. 


interacts with your visitors. While the term CGI These include header and start_htm1 — functions that 
identifies a class of script that allows Web pages to create the HTML header — and tags such as <htm1> and 


interact with the system on which the script is running, <body>, which you need to format an HTML page. 
most scripts are written in Perl. This is because the 
versatility of Perl makes it a good language to use on the 
Web. The basic function of a CGI script is to perform a 
process and then to prepare the output in HTML format so 
that it can display in a Web page. 


Other functions include h1, hr, and end_html. As you see, 
these commands resemble HTML codes. A command such 
as print hi("My Life in 50 Words or Less"); 
takes the place of a print command containing the 
beginning and ending tags for heading level 1 text. 


To use the CGI module that installs on your system, you can 
use the Perl command use CGI;. This command loads the 
CGI module into your script. For most CGI scripts, you 
amend this command by specifying that you want to use 
the most command functions. The altered use command 
then becomes use CGI qw(:standard) ;. This allows 
you to access HTML, form generation, and CGI functions. 


You can use CGI scripts to build pages that contain dynamic 
text, because you can use Perl commands to gather 
information from the system or vary the contents of the 
page in other ways. You can also build CGI scripts that 
create a form allowing the user to enter text, and then 
process that text. 
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EJ Type print header; and EJ Type print h1("This is a (4 Type print end_html;. 


press Return. CGI"); and press Return. 


Ll In the Pico text editor, 
type #!/ust/bin/perl -w and 


press Return twice. EH Save your file as testcgi.pl, 


Type print start_html("this © Type print hr; and press and exit the editor. 
4 Type use CGI is a test"); and press Return Return twice. 
qw(:standard); and press twice. 
Return. 
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WORK WITH PERL 


To create a Web form with CGI, you can use commands that create form elements 
such as text fields. While you can create these elements without the assistance of 
the CGI module, the CG] commands simplify the work considerably. For example, 
to create a text field into which a user types information, you can use a command 
such as print textfield('comment', 'Enter your comment',70,80);. 
This command creates a text field, displays the phrase "Enter your comment" in 
the text field, and sizes the field to 70 text characters. You can add a submit 
button with a command such as print submit ("submit comment") ;. What 
happens next depends on the remainder of your code. When you run this script, 
it submits the comments to a process called process_comments.pl. 


Example: 

#/usr/bin/perl 

use CGI qw(:standard) ; 

print header; 

print start_html; 

print hl("We want your comments"); 

print start_form(get, 'process_comments.pl'); 

print textfield(‘comment',’Enter your comment here',70,80); 
print end_html; 
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print end_html; 
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2) Type chmod a+x testcgi.pl Lud Enter your password if In the URL field of a @ The CGI runs, creating a 
and press Return. prompted. browser, enter http:/Aocalhost |Web page containing system 
/cgi-bin/testcgi.pl and press information. 


ik) Type sudo cp testcgi-pl 
/sw/apache/cgi-bin and 
press Return, replacing 
/sw/apache/cgi-bin with the 
correct path to your cgi-bin 
directory if different. 


Return. 


. INTRODUCTION TO THE X WINDOW SYSTEM 
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+--} 


f 
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enhance the capabilities of your Mac OS X system. 


j Y ou can install and use the X Window System to 


The X Window system is a windowing system that 


facilitates the sharing of windows on a network. For 
example, you can run an application on one system and 
send the display of that application to another system. 


FULL SCREEN VERSUS ROOTLESS 


The X Window System, often referred to simply as X 
Windows or X, can be run in one of two modes. The 
first is full-screen mode. In full-screen mode, the X 
window server takes over your desktop, replacing Aqua. 


There are several versions of X Windows that you can run 
on Mac OS X. XDarwin is a port of the XFree86 software 
and is free. You can also get an X77 implementation from 
Apple that is also based on XFree86 and is a relative 
newcomer to the X scene. There is a commercial X 


In the world of X Windows, the terms server and client 
take on new meanings. The X server is your display — 
the screen in front of you that you can think of as 
serving you windows — and the environment in which 
your X applications run. The X client is any application 
that produces output for the server to display. Another 
important player in the world of X Windows is the 
window manager. A window manager, such as twm or 
Enlightenment, adds a layer of control to your desktop 
and stylistic elements to your windows. Desktops 
attempt to provide a more complete interface to the 


In addition, if you install X Windows on your Mac OS X 
system, you can take advantage of numerous tools that 
were specifically built to work on the system. X is a 
windowing system that works through the cooperation of 
separate components. The native windowing system on 
Mac OS X is called Aqua. 


The second is called rootless mode. In rootless mode, 
the X windows live side by side with your Aqua tools 
rather than taking over the screen. 


Window System implementation called XTools available 
from Tenon. All X servers perform the same function and 
support the X protocol. Given the significant efforts, 
installing an X server on your Mac OS X system should 
not be difficult. 


system and generally provide a suite of integrated tools 
and applications. 


Many Unix desktop environments support X Windows 
natively. This is true, for example, of the common 
desktop environment (CDE) run on Solaris, and 
GNOME and KDE on Linux systems. Aqua does not 
provide support for X Windows without add-on 
software such as XFree86 any more than Microsoft 
Windows does. For these systems, you may acquire 
and install X server software separately. 


While you will probably install only one version of X 
Windows on your system, the choice of which window 
manager and desktop to use is up to you. Two of the 
more popular desktops are GNOME and KDE, both of 
which are popular with the Linux community and 
increasingly available for Mac OS X users. The XonX 
project, which refers to X Windows on Mac OS X, is a 
good source of information and software. 


You also have a choice of what clients to run on your 
server. The xterm client is a terminal tool much like the 


HISTORY OF X WINDOWS 


The X Windows System was originally developed at MIT 
with support from DEC. It was originally meant to 
provide a distributed hardware-independent user 
interface for the Athena project. The software reached 


DISPLAY AND THE XHOSTS COMMAND 


When using X Windows, your display has an address 
that is associated with the environment variable 
DISPLAY. If you print the value of this variable by typing 
echo $DISPLAY in a Terminal window while running an 
X server, you will notice that the value will be set to 
0:0.0 or simply 0.0. While this address may seem to have 
no significance, it actually refers to the first screen 
associated with the first X server on your system. The 
address of your display from the perspective of another 
system on your network would be ferro: 0.0 if your 
hostname were ferro. 


When you are generating a display on one system and 
sending it to another, you need to do two things: 


1) Set your DISPLAY variable on the system where the 
client is running; this is the system generating the 


RUN THE X WINDOW SYSTEM 


Terminal application on your Mac OS X Aqua desktop, 
except that xterm runs on an Xserver. Similarly, xclock is 


an X Windows clock. While these tools are fairly basic and 


part of every X Windows implementation, they do not 
define the limits of what an installation of X Windows 
can do for you. Many powerful applications, such 

as OpenOffice, an office automation tool much 

like Microsoft Office, and the Gimp, a sophisticated 
image-editing tool, are available to you free if you 

first install X Windows. 


version 11, sometimes referred to as X11, before a 
general interest had developed. Control of X11 has 
since been taken over by the X Consortium which now 
maintains the standard. 


2) Run the xhost command on the X server to give 
permission to the remote system to write to your 
screen. 


The xhost command can be run in such a way that it 
only adds the specific client or so that it allows any 
system to write to its display. It is generally more secure 
to restrict access to your screen but this, of course, 
depends on your situation with respect to the security 
of the network to which you are connected. 


To send the output from an X client system to the X 
server running on ferro, you would type setenv DISPLAY 
ferro:0.0 on the client system and xhost + on ferro to 
allow any system to update your display. Enter a specific 
hostname instead of the plus sign (+) if you want to 
restrict this access. 


display. | 
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GET X SOFTWARE FOR MAC OS X 


ree software for running X Windows is available on the 

Web. While downloading and installing this software 

takes a lot of time, the process is straightforward and 
you are unlikely to have any problems with the basic 
installation of X Windows. 


Before you begin to download X Windows, you should 
determine which release is the latest. As of this writing, 
XFree86 is available in version 4.2.1.1 and the instructions in 
this chapter detail how to download the proper files and 
install this release on your Mac OS X system. If a newer 
release is available, you should install it instead. The process 
of obtaining the files and installing the software is not likely 
to change, but the exact names of the files will reflect the 
newer release. 


To begin the process of installing XFree86 for your Mac OS 
X system, enter the URL http://sourceforge.net/projects/ 
xonx in your browser. 


JARE FOR MAC OS X 


When you scroll down the page, you will find a section that 
provides information on the latest file releases. This will 
provide you with the current release information you need. 
When you click the View ALL Project Files link, you will see 
a list of the current files. The largest file in this list, the SIT 
file, will be the major release of XFree86. You will need to 
install this release before the ZIP files, which update the 
major release with patch files. When there are two or more 
for the same sub-release, as there are with 4.2.0.1, you will 
only need to install one of these files. You will install each 
of the patch releases in order. That is, you will install the 
oldest sub-release first. After installing the major release 
and each of the sub-releases, you will have 4.2.1.1 of 
XFree86 installed on your system. 
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RUN THE X WINDOW SYSTEM 


When downloading software Some files, like the XFree86 XInstall_10.1.sit file are 
such as XFree86 to your system large and will take a long time to download on a 
for subsequent installation, it is dial-up connection. If you are installing this 

good practice to store all of your software on a personal system and using a dial-up 
downloaded files in a single line, you may want to consider starting late at night 
directory. While file systems like and checking in the morning to see if the download 
that which Unix uses are meant completed properly. The ZIP files needed to bring 
to help keep your personal files this release up to the current release are relatively 
and application software small and do not take long to download. 

organized, it is easy to allow 
your file holdings to become 
disorganized and difficult to 
clean up sufficiently after the 
fact. 


The sourceforge.org site is a good site to bookmark. 
This site is one of the major places for learning 
about and obtaining open source software. 
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‘li The file saves to the 
location you chose in step 6. 
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provided X Windows with a legitimacy that furthered its 
importance in the commercial world. At the same time, the 
XFree86 Project continued development of X for the open 
source community. The Open Group formed X.org in 1999 
to continue fostering the development of X. 


f someone says the word "windows" in the context of 

computers, most people today immediately think of 

Microsoft Windows, but the original windowing systems 
predate Microsoft's products by many years. XFree86 is a 
direct descendant of the X11 Window System — the first 
windowing system used on Unix. X Windows was developed 
in the 1980s, originating as part of the Athena project at MIT 
and intended to provide a hardware-independent windowing 
environment. Today, X Windows runs on many types of 
systems and under many different names. Hummingbird's 
Exceed is an X Windows server for Intel-based systems. The 
CDE desktop environment used on Solaris and other Unix 
desktops is an X Windows environment. XFree86 is an 
implementation of X Windows that has more than 12 years of 
development behind it. 


Today, XFree86 is one of the most critical of the open 
source projects. It provides X windowing support to a large 
portion of the open source Unix systems and ships with 
most Linux distributions. Currently in Release 4.2.1.1 and 
available for the latest Mac OS X release, XFree86 is a solid 
implementation of X Windows and one that will continue 
to develop along with the open source community. 


The name XFree86 was first used in 1992, replacing the 
name X386 used in the preceding year of development. 


By the late 1980s, the X Consortium had taken control of X 
Windows development. With powerful members like Sun, 
Hewlett-Packard, AT&T, DEC, and IBM, the consortium 
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Click the drop-down 
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where you want to save the 
file. 


location you chose in 
step 10. 


Getting XFree86 on CD-ROM 


overly complex or time-consuming, you can 
obtain XFree86 on CD-ROM. For a modest fee, 
the same version of XFree86 that you can 
download from the Web is available on CD. 
Purchasing the CD will save you the trouble of 
downloading the proper set of files from the 
Web. Visit www.xdarwin.org for information on 


the XDarwin project. 
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developers to share code. 


XDarwin is the name of the X server for Mac OS X 
that is included in the XFree86 distribution. XonX is 
a SourceForge project used by XFree86 for Darwin 


You can get all of the XFree86 source code from 


www.xfree86.org. 


After your XFree86 software is installed, you start it 


by double-clicking the XDarwin icon. You will 


probably find that keeping XDarwin in the Dock is 


the most convenient way to use the software. 
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UNIX FOR MAC 


__ INSTALL AN X SERVER 


ou can install an X server on your Mac OS X system. 
After X Windows is installed, you can then run many 
applications built to run in X Windows. 


means X Windows on Mac OS X is the place to start. 

The XFree86 4.2.0 file is roughly 56 Mbytes in size, so 

be prepared for a long download time if you are using a 
dial-up connection. Check the XonX site for updates. Any X 
To install XDarwin, the port of XFree86 to Mac OS X, you server that is more than six months old is likely to have new 
will need to download a series of files or procure an patches available or have moved to a new release. 
installation CD. As of this writing, you will need to install noe . 

XFree86 4.2.0 followed by two patch releases — 4.2.0.1 and After this file is downloaded, you can double-click the SIT 
4.2.1.1 — to get a trouble-free installation for Mac OS X file to install the initial X Windows server and then install 
10.2. This gives you a basic X environment. You will each of your patch files in release order. The patch files are 
probably then want to quickly move beyond the default available as ZIP files. You can install these updates, or 
window manager, twm, to one that provides a more patches, by double-clicking the icons. 


SRNR nd esate Eonar? If you are working on a dial-up Internet connection, 


you might prefer to install XFree86 from a CD-ROM. 


One of the simplest ways to install Xfree86 is to acquire the : hg ‘ 
You can acquire CDs at minimal cost from sites such 


4.2.0 release in the form of a SIT file from sourceforge.net. 


The URL sourceforge.net/projects/xonx where "xonx" as www.gnu-darwin.org. 
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a0 In the Finder, open 74 Double-click the file. The file unzips. 
the folder containing your 
downloaded XFree86 SIT file. 
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While the procedure described below installs 
basic X Windows, keep in mind that the version 
of XFree86 that you should install will change as 
time passes. Consult the XonX site and amend 
the filenames and your procedure according to 
the information available on this site. 


You can also install an X server using Apple's Get 
MacOS X Software... link from your Apple menu. 
Apple's X server is called X11 for Mac OS and, at 
this writing, is a Public Beta release. Apple's 
implementation of X Windows is also based on 
XFree86. 


Files used in X Windows include .Xdefaults, which 
sets default preferences for windows services, and 
.xinitrc, which establishes your initial screen setup. A 
typical .xinitrc file might start several windows on 
your display. These will often include the more typical 
X clients, such as xterm — a terminal emulator; 

xlock — a simple analog clock; and xeyes — a pair of 
eyeballs that follow your cursor around the screen. 
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Details 
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OroborOSx-Folder Xinstail_10.1.sit 


<4) Double-click the XInstall Ba) Type your password. 


EY Click OK. 
@ The Authenticate dialog 
box appears. 
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Mf The language selection 
file. dialog box appears. 


L3 Click the drop-down 
menu to select a language 
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v4 Click OK. 


Hi Continue through the 
remainder of the installation. 


from the menu. 
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INSTALL XFREE86 UPGRADES 


XFree86 installation up to the current release from 

the base release. Upgrades will usually bring bug fixes 
and performance improvements and are generally worth 
the time that it takes to install them. Because the ZIP files 
containing the modified files are generally small, the 
process of downloading and installing them takes little time 
and little effort. 


Y: can install XFree86 upgrades to bring your 


The upgrade installations complete the installation and 
assume that the two upgrade files have been downloaded 
as described in the "Get X Software for Mac OS X" section. 
While one specific upgrade is being installed in this section, 
this process is repeated for both of the upgrades 
downloaded in the previous section and for other upgrades 
that you may need to install in the future. 


XFree86 upgrades are distributed as ZIP files. The easiest 
way to instal! one of these files is to double-click the icon in 


INSTALL XFREE86 UPGRADES 


the Finder. This will unzip the file and create an install file. 
When you double-click the install file, your upgrade 
installation will begin. 


As with most installations of this type, you will be required 
to authenticate yourself so that the system can verify that 
you are an administrator on the system and have the 
authority to install applications. 


The process will then run through a couple of additional 
steps. You will have to select the disk on which the software 
is to be installed. You should select your Mac OS X system 
disk to simplify administration. Click Next to proceed with 
the installation and click Install before the software starts to 
load onto your drive. The installation can be restarted if 
needed. Whenever you install more than one upgrade, be 
sure to install them in the order in which they were created. 
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@ The file unzips. 


4 Double-click the install 
file for your XFree86 upgrade. 


-3 Type your password. 
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XFree86 4.2.0.1 


Doers aaa a ee 


ee 


ay 


instalAnywhere will quide you through the installation of XFree86 
4.2.0.1. This update includes bug and compatibility fixes for 
XFreeB6 4.2.0 on Mac OS X 10.2. 


It is strongly recommended that you quit all X11 programs before 
continuing with this installation. 


Click the 'Next’ button to proceed to the next screen. H you want 
ta change something on a previous screen, click the ‘Previous’ 
button. 


You may cancel this installation at any time by clicking the ‘Cancel 
button, 


@ The Introduction page 5] Click Next to continue. 


appears. 
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After XFree86 is installed on your system and you 
have verified that it works properly, you can 
remove the ZIP and install files for the upgrades 
along with the SIT file for the major release. If 
you do not need the space, keeping these files 
available in case a re-install is needed is probably 
a good idea. There is little reason to keep these 
files after you install and verify a new major 
release, like XFree86 4.3. 


While XFree86 is an extremely useful tool and 
enables you to run many applications previously 
not available on Mac OS X, the look and feel of 
your X environment depends on the window 
manager that you decide to use. For most X 
users, installing XFree86 is just the beginning of 
setting up a versatile X Windows environment. 


Where Would You Like to instali XDarwin? 
inside “Applications® ort the disk “Mac OS X Startup Disk” 


~ Restore Default Fotder > € Choose: > 


@ The Choose Install Folder 
Page appears. 


ey Select your disk, if 
applicable, and click 
Next to continue. 


| '@ Introduction 


identified. 


If you need help with XDarwin, you can take 
advantage of the discussion forum on the 
www.xdarwin.org site. You can also look for 
in-depth information on technical issues at the 
SourceForge/projects/XonX site. The XonX site 
provides a public discussion forum as well as several 
mailing lists that are devoted to such topics as 
porting Unix software to Mac OS X. 


Pre~instaflation Summary 


oose Instat Folder 
fnstalation Summa’ 


XFreesé 4.2.0.1 


F | | istz Folder: 
“Apolications" on the disk “Mac OS X Startup Disk" 
arget): 


Disk Space information (for 
Required: 7,551,562 bytes 
Available: 11,755,593,728 bytes 


£ "Previous > [F install 


The installation disk is Wd Click install to complete 


the installation. 


A summary description of | Mf The installation completes. 


the software appears. 
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START XFREE86 IN ROOTLESS MODE 


ou can start up your X Windows server in rootless 
mode. This allows you to run X applications 
side-by-side with Mac OS X applications. 


Each time you start XDarwin, the system will ask whether 
you want to run in full-screen or rootless mode. If you will 
always be running in one mode or the other, you can select 
your mode and click the check box so that the application 
stops asking you this question. Both modes have their 
advantages, however. 


To start in rootless mode, click the Rootless button after 
double-clicking the icon for your XFree86 application or 
after starting it from the Dock. The X Windows that launch 
when you do this depend on the contents of your system's 
.xinitrc file or on your personal .xinitrc file if you have one. 
For example, the following lines from an .xinitrc file would 
start up several xterm windows and a clock: 


xclock -geometry 50x50-14+1 & 

xterm -geometry 80x50+0+0 & 

xterm -geometry 80x20+400-0 & 

exec xterm -geometry 80x66+0+0 -name login 
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System Preferences 


TextEdit Utiities 


xFree86_4.2.0_for_Darwin 
nstaitLog.xmt 


You will notice these windows when you start your X 
session. The numbers associated with the xterm command 
define the number of columns, the number of rows, and the 
screen location. For example, the first xt exm defined in the 
lines above will have 80 columns and 50 rows; 80 columns 
wide is equivalent to the width of 80 mono-spaced 
characters side-by-side. Its upper-left corner will be placed 
in the upper-left corner of the screen. 


The most convenient way to start X Windows is to elect to 
keep it in the Dock after you first bring it up. You can then 
customize the windows that start by making a copy of the 
system-wide .xinitrc file and installing that copy as .xinitre in 
your home directory. 


When you first install XFree86, you will be using the default 
window manager. It is called twm and, while it adds some 
window controls to your windows, it is a dull window 
manager. 


“= XDarwin File Edit. Window Help 


Wetcome to XFreaké 


Welcome to XDarwin, a window server for the X Window System under 
Mac OS X. XDarwin is provided by the XFree86 Project and is distributed 
under the terms of the MIT X11 / X Consortium License. This software is 
provided AS IS, with no warranty. Please read the License before using. 


For more information, bug reports and the fatest versions, 
please visit http://sourceforge.net/projects/xonx/. 


The X11 environment can display windows on a separate virtual screen 
or rootless on the Mac OS X desktop. Choose the display mode to use: 


5 © 


Fut screen Rootless — 


ca Always ask for display mode 


@ The Welcome to XDarwin gj Click Rootless. 
window appears. 


LB Double-click the XDarwin 
application icon. 


| 27: 
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You can update your search path to include X 
Windows tools. This will allow you to start X 


You can change the colors used on a xterm window 
by modifying the parameters used in your .xinitrc 


tools by entering their names without a full file. The command "xterm -n xterm- 
pathname. X tools will usually install in the blahblahblah -bg black -fg white - 
directory /usr/X11R6/bin. By including this path geometry 80x25+0+0 &", for example, 

in your PATH variable, you instruct your shell to generates a window named "xterm-blahblahblah" 
look in that directory when you enter a simple with a black background and white letters. The 
name such as xeyes. Terminal window would be 80 columns wide 


(standard width) and 25 lines long beginning 


Your search path, defined in your .tcshrc file, will in the upper-left corner of the screen. 


look something like this: 


Example: 


setenv PATH /usr/bin:/bin:/sbin: / 
sw/bin: /usr/local/bin: /usr/X11R6/bin 


~@ MDarwin File Edit Window Help & XDarwin File Edit Window Help 


fe} tegen 


jel sherri 


@ X clients launch on your Type xeyes in an xterm The xeyes tool opens on 
Aqua desktop, displaying window and press Return. your desktop. 
three screens by default. 
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system if you have first installed an X server such as 


Y ou can install the GNOME desktop on your Mac OS X 
XFree86. 


GNOME is one of the most popular X Window System 
desktops. Developed for the Linux community, GNOME 
now runs on Solaris and Mac OS X systems as well. Because 
this porting effort is recent, installing Gnome can be a slow 
and somewhat problematic installation — especially on a 
slow dial-up connection. You can also acquire binaries on 
CD-ROM. The following sites provide information on X 
Windows for Mac OS X. 


http://sourceforge.net/projects/xonx 
http: //www.xdarwin.org 


After GNOME is installed on your system, you can use it as 
your X Windows desktop. To use GNOME, you should edit 
your .xinitre file and add the line exec gnome-session to 
the bottom of the file. Be sure to comment out the line that 
starts the default window manager, twm. The bottom of 
your .xinitrc file, after editing, might look like this: 
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gnome-wm & 
exec gnome-session 


The next time you start X Windows after making these 
changes, your desktop will start running with GNOME. As 
with XFree86 out of the box, you can run GNOME in 
rootless or full-screen mode. When you run rootless, your X 
Windows will take on the appearance of GNOME windows, 
using the GNOME window dressings. The rest of your 
windows will retain their Aqua look. You will be able to 
start additional X tools from your xterm windows. For 
example, you can start the xeyes tool by typing 
/ust/X11R6/bin/xeyes in an xterm window and 

pressing Return. 


When you start GNOME in full screen mode, as is generally 
the case, GNOME will take over your desktop. All vestiges 
of your Aqua tools and menus will disappear from view. 
GNOME menus will be available on your desktop for 
starting any of a number of X applications. 
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Edit View Go Window Helo 
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XDarwin 


LB Click XDarwin in the 
Dock. 
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Welcome ty Xbeess 


Weicome to XDarwin, a wincow server for the X Window System under 
Mac OS X. XDarwin is provided by the XFree86 Project and is distributed 
under the terms of the MIT X11 / X Consortium License. This software is 
provided AS 1S, with no warranty, Please read the License before using. 


For more information, bug reports and the latest versions, 
please visit http: //sourceforge.net/projects/xonx/. 


The X11 environment can dispiay windows on a separate virtual screen 
or rootiess on the Mac OS K desktop. Choose the display mode to use: 


; Fullscreen 


6) Always ask for display mode 


FA Click Full screen. 


Bi The XDarwin welcome 
screen appears. 
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Many of the applications available through the 
GNOME desktop are traditional X tools such as 
xterm, a terminal emulator, and xcalc, a simple 
calculator. Other applications, such as xv and the 
GIMP are quite sophisticated tools for 
manipulating images. 


| To exit the GNOME desktop, click Desktop > 
Log Out. 


included in the GNOME menus but installed on your 


| You can also start other X applications, those not 
system, by typing their names in an xterm window. 


GNOME supports the concept of virtual 
desktops. The small object in the bottom left 
hand corner of the screen represents each of four 
virtual desktops. You can move from one desktop 
to the next by clicking any of the four rectangles. 
The upper left rectangle represents your default 
screen. If you do not like working with a cluttered 
desktop, you can start different applications on 
each of the four virtual desktops and move from 
one to the other as needed. 


z + 
 XDarwin file Edit Window Help | %, Progiams Favorites Settings Desktsp coco PM [Fh 


fol Screen Ktreesé 
Matintost HD 


The X11 environment wilf take over your entire screen. To 
switch from X11 back to the Mac O% X desktop, hoid down 
Command-Option~A. (This key combination can be changed 
from the Preferences.) To return to Xil, click on the XDarwin 
icon or hold down Command-Option-A again. See the Help 
menu for more information. 


V show this window on startup 


@ A window appears, stating <3 Click Show X11. i XDarwin launches in i The GNOME desktop 
that full-screen mode will take full-screen mode. appears. 

over your screen, and telling 

you how to return to the Mac 

OS X desktop. 
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EXPLORE GNOME APPLICATIONS 


useful tools and applications when you run the 


Y ou can take advantage of an impressive collection of 
GNOME desktop. 


The GNOME desktop includes a number of utilities and 
applications that are built into the desktop. That is, you can 
start up these tools by selecting them from the menus 
available to you on your GNOME desktop. Some of these 
tools are simple applications that can make your system a 
little nicer to use. Others will make a tremendous 
difference in what you are able to accomplish on your 
system. 


The GNOME Programs menu contains a number of sub- 
menus, each with a variety of tools. The Applications menu 
includes tools such as emacs — a highly configurable editor, 
and Gnumeric — a spreadsheet program. The Utilities menu 
provides access to a simple calculator, a color browser, and 
other tools. The graphics menu provides access to GNOME 
Ghostview, a tool for viewing PostScript files; the GIMP, an 


EXPLORE GNOME APPLICATIONS 


rie Favorites Settings Desktop GRi200PM FY 
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Xf, Settings > vim 
| @ System 
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a Gtaphics 


A Click Programs > 
Applications. 


The set of applications 
available on the GNOME 
desktop appears. 


SAEs 


image editing program; and xv, a program for viewing and 
modifying image files. Each of these tools can be an 
extremely useful addition to your desktop. 


The look of your GNOME desktop will vary quite a bit 
depending on the window manager that you decide to use. 
Several are available to you and others can be obtained. 
Enlightenment and Window Maker are used in screenshots 
in this book. These two window managers have extremely 
different appearances, but will, of course, run the same 
applications. The third choice, twm, is also available. To alter 
your window manager, click Settings > Desktop > Window 
Manager. When you change your window manager, you will 
have an opportunity to save your new settings. 


Xterm windows are similar in character and to Terminal 
windows; therefore, you should be able to use these 
windows in the same manner that you would use the 
Terminal application when you are running in Aqua. 
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Click Programs > Utilities > 


Simple Calculator. 


If your GNOME desktop opens without 
the panels at the top and bottom of 
the screen, type panel —no-xshm in an 
xterm window. 


Clicking the globe in the bottom panel 
will open Mozilla, the Web browser. 
With this tool, you can browse the 
Web the same as you would using 
Internet Explorer or Safari on your Mac 
OS X desktop. 


You can make the bottom panel slide 
over to the edge of your screen by 
clicking either end where the small 
arrow is displayed. 


RH Click X to close the 
calculator. 


The GNOME Calculator 
tool opens. 


RUN THE X WINDOW SYSTEM 


The Window Maker window manager gives your 
GNOME desktop an entirely different look and feel. 

If you selected this desktop by clicking Settings > 
Desktop = Window Manager, your desktop will 
change character. You can start up additional virtual 
desktops or workspaces by right-clicking in the 
background and clicking Workspaces New. You will 
then be able to navigate between these workspaces by 
clicking the backward and forward buttons on the icon 
in the upper-left corner of your screen. 


Within each workspace, you can then start different 
tools as if you had a number of work surfaces for 
working on different projects. 
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Graphics 
OME Ghostview 


The menu shows 
Ghostview, the GIMP, and xv. 


Click Programs 
Graphics. 


oe 2 


INSTALL OROBOROSX 


advantage of X tools on your Aqua desktop. 

OroborOSx allows you to run X applications while 
maintaining the look and feel of your normal Mac OS X 
desktop. 


Y ou can install the OroborOSX desktop to take 


The OroborOSX window manager actually provides several 
graphical themes. One of these mimics the look of your 
Aqua desktop and gives your Mac OS X and your X 
applications a seamless appearance. OroborOSxX also 
provides a drop-down menu of applications that can be 
launched from your desktop when you are running 
OroborOSx. This menu appears at the top of your 
OroborOSxX screen and is titled Launch. One of these tools 
is the GIMP, the impressive open source image-editing tool 
that rivals the capabilities of PhotoShop. 


Installing OroborOSX is a smooth process after XFree86 has 
been installed. The OroborOSX application can be retrieved 
from any of several places — http://oroborosx.sourceforge. 
net/download.html and both binary and source distributions 
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OroborOSX-v0.8.5 tar.gz 


if Double-click the icon for 
the most recent version of 
OroborOSx. 


are available. This section outlines the process of installing 
the binary file, which is downloaded as a gzipped TAR file. 
When you double-click this file, you will walk through the 
installation process. OroborOSxX will be installed in a matter 
of minutes and will be ready for use. 


You might want to keep OroborOSX in the Dock to 
facilitate its use. You will then be able to start X applications 
by first clicking on OroborOSX in the Dock and then 
starting your X application through the Launch menu or by 
entering the pathnames for the binaries in an xterm 
window. When you launch OrorborOSx, it will in turn 
launch XDarwin. 


OroborOSx is a good choice for anyone who wants to work 
in their normal Mac OS X desktop while adding some 
applications that only run in X Windows. Installation is 
trouble-free and extremely quick. 
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ATAR file and a folder 
appear. 


¥4# Double-click the 


OroborOSX-Folder icon. 
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After OroborOSx is started, you can keep it in When you are running OroborOSx, all of the 


the Dock to make it easier to start when you windows that you have open will be listed at the 
want to use it again. Because OroborOSX works bottom of your Windows menu. To move from one 
so well with your Mac OS X desktop, you may to the next, you can click the window of your 
sometimes forget that you are running X choice as you would normally do, or you can 


Windows simultaneously with your Mac desktop. | choose the window that you want to make active 
by clicking Windows and the name of the window 


If you would like your inactive windows to that you want to make active. 


appear dimmed, you can accomplish this by 
clicking Options > Dim Inactive Windows. OroborOSx is an Aqua-like window manager based 
on a window manager named Oroborus. 


OroborOSX does not make use of your .xinitrc 
file. However, you can get it to read and execute 
the commands in this file if you click Launch > 
xinitre. 
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the new OroborOSX OroborOSx icon. XDarwin. 
application. 


VIEW IMAGES WITH XV 


program for X Windows, to display, crop, stretch, 

and dither images of many different types. To start xv, 
type xv in an xterm window. If you are using GNOME, you 
will find the program in the Graphics menu. A colorful fish- 
out-of-the-water banner will greet you. Near the bottom of 
the page, you will see the message Press <right> mouse 
button for menu. To view the control panel for xv, press 
Control + click. 


Yo can use xv, an interactive image manipulation 


To load an image, click the Load button. This will open a file 
browse window that allows you to select the image that you 
want to load. The image will load on your screen after you 


click OK. You can use the options under the Image Size 
button to control the size of the image on your screen. 
The algorithms included in the Algorithms menu include a 
number of image manipulation routines that you can apply 
to the image. These include blur, sharpen, edge detect, 
emboss, oil painting, and copy and clear that rotate the 
image with and without blanking out the corners, pixelize, 
spread, and despeckle. For dabblers, there is also an 

Undo All option that reverses any changes you have made, 
bringing you back to the original image. xv operates on GIF, 
JPEG, TIFF, PBM, PGM, XPM, X11 Bitmap, Sun rasterfile, 
Targa, RLE, RGB, BMP, PCX, FITS, and PM image files. It can 
also generate postscript. 
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LB Type xv in an xterm 
window and press Return. 


The xv welcome page 
appears. 


welcome page. 


y4 Command-click inside the The xv controls panel 


appears. 
EX Click Load. 
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The program can be downloaded from After you have modified an image, you can save it 


www.trilon.com/xv/downloads.html in source using the Save button. Fhe Format menu in the 
form and is included in binary format in the upper-right corner allows you to select the format 
Darwin Collection: Free Software for Darwin OS | for your saved image and, depending on the 

and Mac OS X CD set for those who don't want image type you select, asks if you want to use 

to compile their own code. The program is compression. 


available in binary form on the trilon site, but 
not for Mac OS X. Manuals are available in 
PostScript, PDF, and HTML format. 


You can load a number of images and flip through 
them using the Next and Prev buttons. 


You can crop an image by first selecting the area 
you want to retain using your left mouse button and 
then pressing Crop in the xv controls. 


You can close the xv controls panel any time you 
like. To get it back again, press 3% + click in the 
displayed image. 
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@ The xv file load window aa Select an image file. ot The image file displays 
opens. I Click Ok on-screen. 


EDIT IMAGES WITH GIMP 


images. The GIMP, which stands for GNU Image 

Manipulation Program, is a freely distributed software 
tool that allows you to retoucf photos and compose 
interesting images using a maSsive set of features. The tool 
is available from www.gimp.org/download.html and is often 
loaded when you install an X desktop, such as GNOME. 
GIMP is also included on the CD that accompanies this 
book. 


Y ou can use the GIMP to manipulate photo quality 


In an X windowing environment such as OroborOSxX or 
GNOME, you can launch the GIMP through a menu. To 
launch the GIMP in OroborOSx, you click Launch > 
MacGimp. 


Unlike most of the tools that you will use in X Windows, 
the GIMP opens a number of windows on your desktop. 
The toolbox provides the main controls by offering a grid of 
icons, each of which represents a different function, such as 
selecting a portion of the image, zooming in or out, and 
painting on top of the image with brush strokes. 


The toolbox also contains the File menu that provides for 
opening and saving images. It also allows you to modify 
preferences, such as the default image size and resolution, 
that apply each time you use GIMP. The toolbox is like a 
toolbar that lies along the top of most applications. 
Because it is a separate window, you can open and close 
it as needed. 


For serious image work, you will probably find layers 
essential. The best way to think of layers is to picture your 
image as composed of a number of transparencies, each 
which contributes a portion of the overall image, and 
yourself as looking through all of them at once. As you work 
with your images, the layers that you create will display in 
the Layers, Channels & Paths window that opened when 
you first started the GIMP. The active layer will always 
appear highlighted. 
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Rebuild Launch Menu 


Open “Launch Menu items”... 
Open “Helper Scripts”... 


Edit Startup items... 
Run xinitre 


xterm 
xeyes 
xedit 
xcutsel 
xclock 
xcale 
xbiff 
NEdet 


LB Click Launch ® MacGimp 
in OroborOSx. 


Options 
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FA Click File > Open from 
the GIMP menu. 


@ The GIMP window 
appears on your screen. 


You can delete a layer by pressing and holding 
down the right mouse button in the Layers, 


elements that you add to an image if they do 
not look as you had intended. 


any point in time, by selecting the layer in the 
Layers, Channels & Paths window. When you are 
completely satisfied with the overall image that 
you have created, you can collapse your image 
into a single layer. After performing this step, you 
cannot manipulate layers separately. 
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To save an image, press # + click within the image 
window and click File > Save As from the pop-up 


Channels & Paths window and sliding down to menu. If you want to save an image in the original 
Delete Layer. The ability to delete a layer is one format, you can leave the option for Determine 
of the best reasons to work with layers in the File Type by Extension as is and type in your new 
first place. They allow you to easily remove filename. GIMP's format is called XCF. 


If your image has layers, you will have to collapse 
the layers using the Layers > Flatten Image option 
If you have many layers, you can switch between or export the image to save it in a format that does 
them, determining which layer you are editing at not support image layers. You can preserve the 
layers by using GIMP's xcf format. 
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£4 Select the name of a file. BA Double-click the name of “EM In the Layers, Channels & 


the image file you want to Paths window, click the New 
edit. Layer button in the lower-left 
corner. 
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KY Click the Text Tool in your 
toolbox and then click the 
image. 
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EDIT IMAGES WITH GIMP (CONTINUED) 


by pressing 36 + click within an image and selecting 

from the menu. For example, if you click Filters > 
Glass Effects > Apply Lens, your image will appear distorted 
as if you were looking through a (convex) lens. The filter 
effects also include edge detection, colorification options, 
and various other distortions that you can apply to get the 
effect that you want. Unless you are a full time graphics 
professional, it is likely that you will never use most of 
the tools available in the GIMP. Experimenting with the 
various options, on the other hand, is bound to be good 
entertainment on some otherwise uneventful day and is 
probably the only way to fully understand what this tool 
can do for you. 


Y ou can apply many transformations to your images 


There is also an option to revert to the original image. This 
is available through File > Revert. This is useful if you apply 
a transformation and do not like the way it looks. Many 


EDIT IMAGES WITH GIMP (CONTINUED) 


people who use GIMP make a habit of preserving their 
original images and saving their modified images using 
different names so that they can always start over. 


To crop an image, select the crop tool from the toolbox. 
The icon resembles a craft knife. Then left-click within the 
image window. When you click twice, you should notice 
two sets of corners appear like the diagonal corners of a 
box that move independently. The space between these 
corners, or elbows, defines the portion of the image that 
will remain after you click the Crop button. 


While you might find quite a bit of information on using 
the GIMP on the Web — because this is a very popular 
tool — using the tool is the best way to unveil all of the 
manipulations that are possible and which of them is 
going to work best with your own graphical style. 
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layer. 
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Floating Selection. 
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The 5 x 5 element toolbox allows you to easily If you want to draw on top of an image, you can use 


access the tools available for use within the the pencil tool. The Tool Options window for this 
GIMP. Pausing your cursor over any of the icons tool allows you to modify the opacity of your pencil 
will cause a brief description to appear. stroke and to select a color for your pencil strokes. 
The magnifying glass tool allows you to quickly The icon in the middle of the toolbox that looks like 
zoom in on an image so that you can see more an eyedropper allows you to pick colors from your 
detail and have a finer degree of contro! over image. This allows you to work with colors that 
your work. To zoom back out, double-click the match the colors in your image instead of trying to 


magnifying glass and click Zoom out in the Tool 
Options. Then click the image again. The effect 
of the magnifying glass will then cause you to 
zoom out. You can toggle between zooming in 
and zooming out as needed. 


match the colors by selecting them from a palette. 
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WORD PROCESSING WITH ABIWORD 


AbiWord. AbiWord is an intuitive word processing 

application with the same basic features as Microsoft 
Word. You start AbiWord when you are running an X 
Windows server by typing abiword in an xterm window. The 
tool will open up on your screen, allowing you to begin 
entering the text of your document. You can also open a 
pre-existing Word file. 


Y ou can display and edit Word documents with 


You use the AbiWord program in the same way as you 
would use other GUI word processors such as MS Word or 
Corel Word Perfect. If you trained on older, keyboard- 
oriented word processing systems, you must get used to 
clicking on icons to make things happen. For example, 
formatting a page for right or left justification of text 
requires an easy click near the upper-right corner of the 
screen where pictograms display your choices. 


Other icons may be less obvious but clicking on any of 
them will usuaily bring up a menu with a logical suite of 
choices. For instance, if you want to save your work, you 


click File in the top menu bar and see a menu with Save 
and Save As choices along with open and print options. 
Moving your cursor over the diskette icon causes the 
description to appear — Save the document. If you select 
the diskette with a pencil pointing at it instead, you can 
rename the document. 


To concentrate on writing, you can easily remove most of 
the clutter of your AbiWord menus by clicking on View and 
then checking the Full screen box; only the menu at the top 
of the screen will then remain along with your text. You can 
manipulate tabs and margins with menus, or adjust their 
bars and pointers along the edges of the screen, as though 
you were using a real typewriter. 


As with any program, the fastest way to do something may 
be revealed only after some experimentation with different 
menus and patterns of keystrokes that suit your style of 
typing. If you are an experienced wordsmith, you can use 
these tricks intuitively in AbiWord and save a bundle of 
money by not purchasing expensive commercial products. 
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LE Type AbiWord in an xterm 
window and press Return. 
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AbiWord opens with a 
blank document. 
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If you are writing a newsletter or other AbiWord enables you to import images into your 


publication, you can choose one, two, or three document by using the icon that looks like a 

columns to suit the style of your publication. landscape snapshot. It is probably wise to begin a 
d ith this st h i d th 

You can find documentation for AbiWord, : mpi At ints Geeprawa ten ererereonE ie 

: ; : ‘ image. 

including an overview and a tutorial, at 

www.abisource.com/help. If you have any You can open Microsoft Word files, identified by 

questions about quirks in the program, contact their .doc file extensions, directly in AbiWord and 

the authors at AbiSource.com. As with other then edit and save the files in the Rich Text Format. 


open source products, news about problems 
experienced can be sent upstream to the 
community and tips and tricks can be 
downloaded from other users via discussion 
groups or FAQ pages. 
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Click File > Open. = Click a filename. Your file appears Ey When you have finished, 
i The Open File window on-screen. save your document to keep 
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CREATE SPREADSHEETS IN GNUMERIC 


ou can use Gnumeric for simple calculations to 
complex numerical analysis. Gnumeric is a free 


spreadsheet released under the GNU General Public 
License. It has all the features that you would expect in a 
quality spreadsheet application, including a built-in manual, 
support for graphs, an extensive range of functions, cell 
formatting, and printing. It also has a powerful set of import 
and export filters that allow it to work with Excel, Lotus 
1-2-3, Sylk and other spreadsheet formats. Graphic support, 
however, requires that you also have Guppi installed. 


To start Gnumeric, you can type Gnumeric in an xterm 
window. The tool will open with an empty spreadsheet. 
Entering data is as simple as clicking in a cell and typing text 
or a number. To enter a formula, you start by typing = and 
then you enter the formula, such as cos(100) or sum(A2:A20) 


CREATE SPREADSHEETS IN GNUMERK 


where A2:A20 defines a range of cells. If you are not used 
to spreadsheets, you will have to get accustomed to this 
nomenclature. The columns in a spreadsheet are labeled A, 
B, C, and so on while the rows are numbered 1, 2, 3, and so 
on. A2 is the cell defined by the second row in the first 
column. 


You can also select data by holding down your left mouse 
button and sliding over it. This often simplifies the process. 
Gnumeric, like most modern spreadsheets, will allow you to 
copy and paste a formula, adjusting the cell addresses in the 
process. If you sum A2:A20 and then copy your formula 
from A21 to B21, the new formula will sum B2:B20. If you 
are familiar with any spreadsheet application, you will 
probably be perfectly at home using Gnumeric. 
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ull Type gnumeric in an 
xterm window and press 
Return. 
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The answer appears in 
your cell, and the formula 
displays in the toolbar field. 


@ Gnumeric opens with a 
blank spreadsheet. 


Z4 Type =sqrt(64) in a cell 
and press Return. 
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You can turn a number in a cell into a percentage 
simply by clicking the percentage sign in the 
toolbar after clicking on the particular cell. This 


The undo operation is available both as Edit > 
Undo and through use of the curved arrow in the 
toolbar. Anytime you make a mistake, you can 
speeds up the process of modifying the format of | quickly reverse your most recent operation. 
your numbers, but uses the default format with 
two decimal points. Similarly, you can convert a 
number to display in monetary format by clicking 
the symbol that looks like a stack of dollar bills. 


spreadsheet by selecting these tools from your 
toolbar. 


Icons in the toolbar allow you to change the 
justification of data in cells to right, left, or center 
justified. 


You can use the green and red arrow keys 
near the upper-right corner of the spreadsheet 
to sort a series of cells in alphabetic or reverse 
alphabetic order. Simply select the cells that you Click Help > Gnumeric Manual to open a very 
want to sort and click the arrow representing the | handy user's guide. 

sort order of your choice. 


| You can add arrows and other annotations to your 
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J Type ) and press Return. 
J Type =sum( in the cell 
below. 


UNIX FOR MAC 


VIEW OFFICE DOCUMENTS WITH OPEN OFFICE 


ou can use Open Office to create documents, modify Microsoft Word documents. Open Office comes 

spreadsheets, illustrations, and presentations. You with spell check, clip art, and many of the same formatting 

can also open documents that were created by other features that you would expect in other professional word 
applications, such as Microsoft Office. Open Office is a processing applications. 


suite of office applications that includes a word processor, 
spreadsheet, drawing program, presentation package, data 
source editor, HTML editor, formula editor, and macro and 
scripting language. Each tool is a professional and full- 
featured office automation tool that has years of 
development behind it from talented volunteers from 
around the world. Completely free, Open Office is based 


When you start Open Office from the Dock or by double- 
clicking on its icon in the Finder, the tool opens with Writer. 
From this application, you start the other applications as 
well. For example, File > New > Spreadsheet launches the 
spreadsheet application. Open Office will start XDarwin if it 
is not already running. 


on code from StarOffice and 15 years of development by Most of the items in the toolbar along the top and down 
Sun Microsystems. It runs on Sparc systems as well as the left side of the Writer's window will look familiar to you 
Windows and Linux and, as of this writing, is in the final if you have used Microsoft Word or another word 


stages of development for Mac OS X. processor. If you are unsure of the meaning of any of the 


icons, position and hold your cursor over them and a short 


To use Open Office, you need to first install X Windows. description appears. 


The word processor that is included in the Open Office 
suite is called Writer. You can use it to read, write, and 
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€ OroborOsSx “ OroborOSk Launch  Eciit Options Wwndaw Help 
i=) © 6 Untitled! - OpenOnaice ory 1.0.1 


EM cot View wiser Form Tools Minsow Helo 


Launch fdit Options Window Help 


Lee eel tae J 


OpenOff Ice.org 1.0 


. _— LsUserssemspmoed.sxc 
BD Msers frersSanarich/Puletook-Dece? aoc 


| 
“ETI Click the Open Office B Writer opens with an EA Click Files Open. 
icon in the Dock. empty document. 
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To view nonprinting characters, click View > You can turn the spell checker on and off by clicking 
Nonprinting characters or press Control + F10. If | the symbol that contains the letters ABC with a wavy 
you press Control + F10 several times in a row, line underneath. You can choose to see your spelling 
you will notice how the nonprinting characters mistakes as you type or spell check later. 

toggle on and off. 


You can insert tables by clicking insert Table .. . or 
Depending on the type of document you are by clicking on the table icon near the top of the left 
creating, autocorrection can be a blessing or an window border. 

annoyance. Tools » AutoCorrect/AutoFormat .. . 
allows you to control the extent to which 
autoformatting and autocorrection are used 

in your documents. 


You can easily number the lines in your document 
and have control over the frequency with which 
lines are numbered. For example, you can number 
every fifth or tenth line in a document. Line 

You can save documents created in Writer in numbering is selected through Tools > Line 

many formats, such as OpenOffice text or Numbering. 

template, Word 6.0, 95, or 97/2000/XP, StarWriter, 

Rich Text Format, and HTML. 


_@ OroborOSx Launch Edit Options Window Help 
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LSK-CoverPages File 11/25/2002, 20:08:39 
ib) LSK-CoverPages.p65 P65 -File 11/13/2002, 22:10:02 
) Lsk-Rulebook File 10/04/1970, 05:22:47 
_) Lsk-Rulebook.p65 P65-File 11/13/2002, 22:04:46 
?) LSK-Rules-Nov02.doc MS Word document 11/25/2002, 14:30:42 


5K- Rutes-NovO2 rif STE- pérass200% 16-59 0% 


ReleBeot-L OF doc MO Wore document OOS SKE OP/O4/20027, 130924 
=) RuleBook.doc MS Word document 720.4 KB 06/16/2003, 18:11:20 
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@ A file browser opens. Click Open. i The document appears 


on-screen. 
EJ Select the document you 


want to open. 


CREATE SPREADSHEETS WITH OPEN OFFICE 


or import spreadsheets created by other popular 

spreadsheet applications. The spreadsheet that 
is included with Open Office is called Calc and, like 
Gnumeric, is likely to be familiar and, thus, easy to use if 
you have used any spreadsheet application. The labeling of 
the rows and columns and the symbols in the toolbars are 
generally self-explanatory and, if you pause over them with 
your cursor, a short description will appear to explain their 
functions. 


Y ou can create spreadsheets using Open Office 


To start Calc, click File > New © Spreadsheet from Writer. 
This will open an empty spreadsheet in another window on 
your screen. 


Clicking the Help button will bring up a useful guide on 
how to use Calc along with a panel in which you can enter 
or browse search terms, look through the contents of the 
Open Office documentation or create and use bookmarks. 


CREATE SPREADSHEETS WITH OPEN OFFICE 


As with other spreadsheets, you can enter data or formulas 
in cells and can copy and paste these items to avoid having 
to enter the same data more than once. 


Calc also includes graphing. If you select data and click the 
Insert Object icon, a short series of forms for creating a 
number of graphs, such as pie charts and scatter diagrams, 
will appear. 


Insert > Graphics lets you import images into your 
spreadsheets. 


Like Gnumeric, Calc has one-click options for transforming 
the format of a cell to a percentage or monetary figure. 


Edit > Repeat:Attributes is a very useful function that allows 
you to repeat changes that you make in one cell to others. 
If you change one cell to bold and then use this function, 
the new cell or group of cells will also take on the changed 
attribute. 


oborOSx Launch Edit Options — 


Window Hein 
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eoe 


Launch idm Options Window Help 
Ustitied2 - OpewOMice.org 10.1 


Untitingt - OpenOtiice.org 1.0.1 


In the Writer window, 
click File New > 
Spreadsheet. 
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EJ Select your cells. 


Click the Insert Object 
button. 


@ Calc opens with a blank 
spreadsheet. 


v4 Enter some text and 
numbers into your 
spreadsheet. 


INSTALL X WINDOW SYSTEM SOFTWARE 


Spreadsheets created in Calc can be stored in You can create a slide presentation by clicking 
Open Office format or you can choose from File > New © Presentation from Writer or from 
other formats which include several versions of Calc. The presentation package is called Impress 
MicrosoftExcel, StarCalc, Data Interchange and is a multimedia presentation tool that includes 
Format, dBASE, and SYLK. clip art, animation, and high-quality drawing tools. 
When you start Impress, you will complete a series 
of forms in which you make selections for your 
presentation — such as whether to use wipes of 
some type as your slide show moves from one slide 
to the next. Impress simplifies preparation of a 
presentation and includes many features for 
creating a dynamic slide show. 


You can also create HTML documents in Open 
Office by clicking File > New > HTML 
Document. This tool will allow you to enter text 
and will provide the HTML code. You can insert 
links and create tables using options from the 
Insert menu. While you work with the context of 
the page, the HTML code is being constructed 
for you. 


OroborOSX Launch Edit Options Window Help 
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@ The AutoFormat Chart 


<3 Select a graph type from The new graph appears in 
window appears. 


the menu. your spreadsheet. 
Click Create. 
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DEVELOP C AND C++ APPLICATIONS 


Mac OS X system. Developing applications in C or 

related languages, such as C++, depends largely on 
your ability as a programmer, although the Mac OS X 
environment offers excellent support for your development 
efforts. The gcc compiler that accompanies the Mac OS X 
developer tools is the default compiler for C, C++, 
Objective-C, and Objective-C++. 


Vu can develop applications in C and C++ on your 


Before you begin working in any of the programming 
languages available on Mac OS X, you should update your 
MANPATH to include /usr/share/man. This ensures that the 
man pages for the developer tools are available to you. If 
you type the line setenv MANPATH /sw/share/man:/usr/ 
local/man:/usr/share/man into your .tcshrc file, these and 
other pages appear when you use the man command. 


You should use the text editor to create your source code. 
Many developers prefer emacs because they can configure 


DEVELOP C AND C++ APPLICATIONS 


& Terminal Fit Window Help \ 


La Type vi hello.c and press 
Return. 


them to properly indent source code. However, you should 
use the text editor that allows you to work most effectively. 


After typing your source code, you can compile it using gcc, 
or you can use the make command, which manages the 
compilation process. The make command only compiles a 
program if the associated binary code is older than the 
source code. In other words, it only recompiles your 
program if you have changed the source code. If your 
application consists of multiple source files, you must create 
a Makefile to describe the relationship between those files. 
make calls gcc to compile C programs. 


make works with many different programming languages, 
although it is most often used with C. In fact, make is not 
limited to compiling software. You can read the make man 
page to learn about this versatile command. 


@% ‘Yerminal File Edit Scroliback Font Window Heip 


#include <stdio.h> 3 


printfC"Hello, World\n"); 


a 
7 
ZZ 


*Append ~, 


EHP ee Cre & PF Ate we te 


<j] Type main () { and press 
Return, then press the Tab 
key and type printf("Hello, 
World\n"); and press Return 
again. 


Press | and type #include 
<stdio.h>, then press Return 
twice. 


@ The include command 

adds the standard IO header aS 
file to your program. =a Type } and press Esc, then 
type :wq. 

@ vi saves your source code. 


cc 
gcc 


~c ~o hello.o hello.c 
hello.o -o hello 
{ferro:~/project_X] user% [] 


Type make hello and press 


Return. 


DEVELOP UNIX APPLICATIONS 


Whenever you develop an application using multiple source files, you can build a 
Makefile to define the dependency relationships between files. If you have ever 
installed any applications from source code, you have probably used a Makefile 
to orchestrate the compilation process. 


With a simple program like hello.c, a Makefile is unnecessary. However, when 
you are compiling tools such as fetchmail, the Makefile ensures that you compile 
all of the proper files and that you create the final executable fetchmail. You 

can also write Makefiles to include installation and cleanup instructions. This 
allows the user to use the make install and make clean commands to install 
an application and remove object files. When you use a Makefile, you do not 
need to type commands such as make hello.c. The make command uses the 
Makefile in your current directory. With the following Makefile, you only need to 
type make to compile hello.c. Be careful to use tabs after the : and before gcc. 


Example: 


hello: hello.o 
gcc hello,o -o hello 


Makefiles allow you to control the compilation and installation processes. If 
someone else is installing your application, you can give the installer the source 
files and a Makefile, to ensure their installation is successful. 


Terminal File Edit Scroilback Font Window Help “a “4 File Edit Scrofiback Font Window Help 


EE ite ahs ate ee ea 3 his ooh bn See 
:~/project_X] user® make hello 
-¢ -o hello.o hello.c 


POPS TEN SSNS ETRY PER TMT CTT TONITE Oren Tr 


erro:~/project_X] user% [] 


@ Make calls gcc to compile Type -/hello and press Your program runs. 
your program. Return. 
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DEVELOP JAVA APPLICATIONS 


system. You run Java applications with the java 

interpreter, but you first compile them with a 
program called javac. Examination of the HelloWorld 
program below illustrates why you need a compiler to 
compile Java code into a special intermediate form called 
bytecode, and an interpreter to run the compiled code. 


Y ou can develop Java applications on your Mac OS X 


The following lines of code represent the HelloWorld 
program written in Java. The single print command is 
similar to the printf command in C. The second line 
defines the main method and is the entry point for every 
Java application. In Java, each method or function exists 
within a class or an object, where an object is an instance of 
a class. Thus, you must enclose this simple program for 
printing a single line of text within a class definition. 


public class HellowWorld { 
public static void main(String[] 
System.out.println("Hello, 
} 


args) { 
World!" + 


DEVELOP JAVA APPLICATIONS 


e Terminal File Edit Scroiiback Font 
type 


Fule: HelloWorlds java 


Window Help 


* This is Hello World written in Java 
ef 


q 


Be Get Help J Writedut Jf Read FilefM] Prev Pg J Cut Text M@ Cur Pos = * 
my Exit mi) Justify gf Where is @Mj Naxt Pg fg UnCut Texi§§ To Spell 


CREATE A JAVA PROGRAM 


1 Start the Pico editor 
to create a file named 
HelloWorld.java and 
press Return. 


I The Pico screen appears. 


You normally precede code like this with a line or two of 
comments. Java comments start with /* and end with * / 
and can span multiple lines. Single-line comments can 
start with // and need nothing else. Comments that 

start with /** are special comments, and a tool called 
javadoc — which is intended to provide automated code 
documentation — extracts the text from these comments. 
The javadoc command produces documentation for 
public classes. 


To compile the Hel 1loWorld. java program, use the javac 
command. The command javac HelloWorld. java reads 
your source code and produces a class file, Hel loworld. 
class. You can then run this program with the command 
java HelloWorld. 


Java applications are often distributed as Java archive (JAR) 
files, and you can list the contents with the jar command. 


& Terminal File Edit Scrollback Font Window Help 


{** 
* This is Hello World written in Java 
bad 
public class HelloWorld £ 
public static void main(String[} args) { 
System. out .printin("Hello, World!"); 


Re Get Help M@ WriteOut gh Read FileRm P Cut Text Cur Pos 


mei Justify @y Where is @ me UnCut Texgil To Spell 


ei] Type public static void 
main(String[] args) { and press 
Return. 


Type /** and press Return, 
type * This is Hello World 
written in Java and press 
Return, then type */ 


and press Return. J Type System.out.printin 


("Hello, World!"); and press 
@ Your javadoc comment is | Return. 


lete. 
complete 33 Type } and press Return, 


Type public class then type } again. 
} 302 | HelloWorld { and press Return. 


DEVELOP UNIX APPLICATIONS 


You can create a Java archive from your You can create a Web page containing the javadoc 
HelloWorld application with the jar comments from your HelloWorld application by using 
command. Syntactically, the jar the javadoc command. Javadoc comments provide 
command is like the tar command. To easy to access documentation for Java programs and 
create a JAR file, you can use the jar are generally considered essential to proper Java 

cvf command. To extract from a JAR file, programming. These comments are especially critical 
you can use the jar xvf command. To when multiple programmers work on the same project. 
list the contents of a JAR file, you can use 


ite jax, Eee commen To view extracted javadoc comments, use the open 


command, as in open He1lloWorld.htm1. This will 


TYPE THIS: RESULT: open the javadoc Web page in a browser. 


[ferro:~] user% 0 Thu May 29 TYPE THIS: RESULT: 
jar cvf 21:18:32 EDT 2003 
ae raccia oie =i ee {ferro:~] user% } -rw-r-r- 1 user staff 427 
HellowWorld.class 67 Thu May 29 javadoc May 29 20:57 HelloWorld.class 
ne *18: HelloWorld.java |, 
i As ae ae ae ae 4 -rw-r-r— 1 user staff 6967 
Se open a ‘ {(ferro:~] user’ |. May 29 20:58 HelloWorld.html 
ia 427 Thu May 29 dey 1 
20:57:50 EDT 2003 Helloworld* 
HelloWorld.class 


-rw-r—-r- Jl user staff 754 
May 29 21:18 HelloWorld.jar 


-~rw-r-r— 1 user staff 181 
May 29 20:57 HelloWorld.java 


Terminal File Edit Scroiiback font Window Help “ud @ Terminal file Edit Scroliback font Window Help << 


Pp _X] use 
{ferro:~/project_X] user%|Java HetloWorld] 
H World i “PWePe-re- Jouser staff 181 May 29 28:57]HelloWorld. java 
erro :~/project_X] users [} E (ferro:~/project_X] user% {] 


Save your file and exit EJ Type java HelloWorld and Type Is -I HelloWorld* and The system lists your 
Pico. press Return. press Return. source file and Java program. 
Type javac HelloWorld.java Your program runs. 


and press Return. 


@ Your program compiles. 


DEVELOP PYTHON APPLICATIONS 


system. Python installs with the Mac OS X Developer 

Tools as /usr/bin/python. The command which 
python prints this path; if it does not, you must check your 
PATH variable and this location. 


Y ou can develop Python applications on your Mac OS X 


Python is an interpreted, interactive, object-oriented 
programming language. Unlike C programs which you 
compile, and Java programs which you run on top of a 
virtual machine, Python programs are more like Perl scripts. 
However, the object orientation of Python gives Python 
programs a distinctively different character. 


Even if you are not already familiar with object-oriented 
programming, you can still write useful Python scripts. 
However, to make full use of the language, you must 
develop an understanding of object-oriented programming. 
In fact, many people consider languages such as Python to 


be transitional languages, because they allow you to write 
programs while you are only beginning to grasp the 
concepts of object-oriented programming. 


Languages like C and scripting languages like Perl are 
procedural languages. This means that portions of code are 
organized into functional elements called procedures or 
subroutines that you can use in the remainder of the code. 
Object-oriented languages work differently in that they define 
objects and then a set of operations that you can perform on 
these objects. You refer to these operations as methods. 


Where Perl prints to a file using a command such as print 
LOG "$num records processed" ;, Python uses a 
command such as out_file.write("Testing, 
testing, 1, 2, three\nThat's all folks\n"). 


While, on the surface, these commands may not seem very 
different, the implementation and coding method are 
radically different, and you encounter these differences as 
you write your own methods. 


DEVELOP PYTHON APPLICATIONS 


a Terminal 


File Edit Scroliback 


Font Window Help 


#!/usr/bin/python 
print "Hello, World!” 


{ferro:~/bin] user [} 


CREATE HELLO WORLD 


<j Type print "Hello, World!" 
PROGRAM IN PYTHON 


and press Return. 
14 Start Pico to create a file 
name HelloWorld.py. 


4 Type #!/ust/bin/python and 
press Return. 


EJ Save your script and exit 
Pico. 


f Pico saves your script. 
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cnmad a+x HetloWorld. py 
./Het LoWorld. py 


£4 Type ./Helloworld.py and 
press Return. 


Type python HelloWorld.py 
and press Return. 


Your script runs. Your Script runs again. 


Type chmod a+x 
HelloWorld.py and press 
Return. 


DEVELOP UNIX APPLICATIONS 


While a program as simple as HelloWorld does not display the object orientation of 
Python, creating and working with objects reveals some of the advantages of using 
objects. You can define objects and assign attributes to these objects quite easily in 
Python. To define a class, you can use the class command, such as class Farm. To 
define an instance of this class, you can use a statement like my_farm = Farm (). 
You can then define the attributes of your farm with lines such as my_farm. cows. 


Example: 
#!/usr/bin/python 
# simple program using objects and attributes 


class Farm: 
pass 


my_farm = Farm() 
my_farm.acres = 45 
my_farm.cows = 
my_farm.crops = 2 


print "My farm is ", my_farm.acres, "acres." 
print "We have", my_farm.cows, "cows and" 
if my_farm.crops: 

crop_text = "we grow " my_farm.crops 
else: 

crop_text = "no" 
prant “crops: “ 


Terminal Fite f€dit Scroliback Font Window Help 4 Terminal File Edit Scroflback Font Window Help 


ie 
[[Uferro:~7bin] userX|chmod avx write2tile 
P| [[lFerro:7etny user®] /write2Fite | 
#1/usr/bin/python 2 erro:~/bin] user® 
& fresting, testing, 1, 2, three 
pout_file = open(“mytest", "w") f RThat's all 
fout_file.writeC"Testing, testing, 1, 2, three\nThet's all\n") ; 


ee Crerrs coated saere (f 
out_file.close() i 


[ferro:~/bin] user% fl 


WRITETO A FILE USING PYTHON [3 Type out_file.write("Testing, Type chmod a+x write2file Your script runs. 
7 4 " 
EB start Piaueonemacrle testing, 1, 2, three\nThat's all\n") | and press Return. 


ah ip and press Return. @ The system displays the file 


Type ./write2file and press your script creates. 


2 Type #t/uaetitn/pythion aiid GA Type out_file.close(). Return. 
press Return twice, then type 5 Save your file, and exit Type cat mytest and press 
out_file = open("mytest" ,"w") Pico. Return. 


and press Return. : ; 
# Pico saves your script. 


DEVELOP RUBY APPLICATIONS 


in Ruby. Like Python, Ruby is an object-oriented 

scripting language that installs with the Mac OS X 
developer tools. In fact, there is considerable debate about 
which of the two is the better language. 


Yi can quickly develop object-oriented applications 


The interpreter is /usr/bin/ruby, and the syntax is relatively 
easy to use and, like Perl, extensible. The language is similar 
to SmallTalk, a programming language that is object-oriented. 
For example, in Ruby, you can use the command 3 . times 

{ print "Hello, World!" } to print "Hello, World!" 
three times in a row. 


Because the language has many built-in types, you can 
accomplish a lot with just a few lines of code. Some of 
these types include match and replace commands that are 
similar to commands that you use in Perl. For example, the 


DEVELOP RUBY APPLICATIONS 


pd. 


#! /usr/bin/ ruby 
print “Hello, World!" 


[ferro:~/bin] user% [i 
CREATE HELLO WORLD IN RUBY 


inl Start Pico to edit a file 
named HelloWorld.rb. 


74) Type #!/usr/bin/ruby and 
press Return twice. 


Type print "Hello, World!" 
and press Return. 


EY save your file, and exit 
Pico. 


# Pico saves your script. 


and press Return. 


command string.gsub! (/this/,"that") replaces this 
with that. If you do not find a built-in type that meets your 
needs, you can define your own using the def command. 


Because Ruby is interpreted, you can run scripts by using 
them as arguments to the interpreter — such as ruby 
HelloWorld.rb — or by including the shebang line in 
your script and making the script executable. The command 
ruby -v tells you what version of Ruby you are using. 


Print commands in Ruby look much like print commands in 
Perl or C, but do not require the use of a semicolon at the 
end of the line. New lines are represented with \n. While 
file extensions are not critical on Unix systems, Ruby scripts 
are generally given the file extension .rb to indicate that 
they are Ruby programs. 


[ferro:~/bin] user%[ruby ./HelloWorld.rb| 

Hello, World![ferro:~/bin] user%[ chmod a+x HelloWorld. rb| 
[ferro:~/bin] user%| ./HeLloWorld. rb} 

ferro:~/bin] user® || 


Type ruby /HelloWorld.rb 4 Type ./HelloWorld.rb and 


press Return. 


Type chmod a+x Your script runs. 


HelloWorld.rb and press 
Return. 
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You can print a string in Ruby with or without a carriage return at the 
end, just as you can in Perl and Python. The syntax that each language 
uses is different, as shown in the comparison below. 


PERL 


PYTHON 


RUBY 
print "Hello World"; print "Hello World" | print "Hello World", 
print "Hello World\n"; | puts "Hello World" print "Hello World" 


You can iterate through a sequence of values in Ruby by defining an 
iterate method such as that shown below. 


def iterate (max) 
i, = 10 
while i < max 
yield i 
it=1 
end 
end 


: Hello 
: Hello 
2: Hello 
Hello 

: Hello 


iterate(5{|val| puts “#{val}: Hello World"} 


i erminat File Edit Scrofiback Font Window Hell 


def fact(n) 


Lae * fact(n-1} 


print factCARGV[@].to_i),"\n" 


mea 2 8 ett Ok 8 ta, f 
mel 


DEFINE A METHOD IN RUBY 3 Type n * fact(n-1) and 
press Return, then type end 


4 . 
i ir il” aaa and press Return, then type 


fact(n) and press Return. 


4 Type ifn ==0 and press 
Return, then type 1 and press 
Return, then type else and 
enter a space. 


“3 Type print 
fact(ARGV[0].to_i), "\n". 


end again, and press Return. 


®[ruby] ./Factoriat 4) 
erro:~/bin] users [] 


EA Save your file using the #4 Type .Aactorial 4 and press 
name factorial, and exit the Return. 
text editor. 


m@ Your program prints the 
Type ruby followed by a factorial of 4. 
space. 


RUN A DATABASE ON MAC OS X 


ou can install and run a database on your Mac OS X 

system. In fact, you can choose between two free 

relational database packages — MySQL and 
PostgreSQL. 


When you install PostgreSQL, you first download a gzipped 
TAR file and go through the steps of unzipping and 
untarring this file. You must read the INSTALL file that 
comes with the installation files before you run the 
configure command, as it contains many options that you 
can use to modify your installation. These options include 
the location where you want to install the software and 
whether you want to include readline support if you have 
already installed readline. You can then run the configure 
command with or without options, followed by the make 
command. The make install command installs the 
software on your system. By default, the software installs in 
the directory/usr/local/pgsql. 


RUN A DATABASE ON MAC OS X 


coe 


(ferro: ~] user® tar x osteree ee tar] 


[ferro:~] user%]/cd postgresaqlt- 
[ferro:~] user® |] 


mM Type gunzip followed by 
the name of your postgres 
install file, and press Return. 


v4 Type tar xf followed by 
the name of your TAR file, 
and press Return. 


Wi Your TAR file is extracted. 


KE} Type cd followed by the 
name of your install directory, 
and press Return. 


@ Your install file 
uncompresses. 


Installing the PostgreSQL software does not automatically 
enable you to start issuing SQL commands. You must follow 
a series of steps to create your database. 


The first thing you must do is to add a special database user 
to your system. For PostgreSQL, this user is usually called 
postgres. Your database software runs under this account. 


The next thing you must do is to log onto the postgres 
account and enter the initdb command to create a 
database. You must not use this command as root or with 
the sudo command. 


If you install into the default location, your binaries — 
including initdb — go into this /usr/local/pgsq}/bin directory. 
You must therefore add this directory to your path so that 
you can easily invoke any of the PostgreSQL commands. 


After you run initdb from the postgres account, you can 
create tables, add data, and enter queries. 


File Edit Scrolibac 
nai is seis 
gunzip postgresql-7.3.tar.gz 
(ferro:~] user®% tar xf postgresql~-7.3.tar 
(ferro:~] user® cd postgresql-7.3 


checking buiid system type... powerpc-apple-darwint.3 

checking host system type... powerpc-apple-darwin6.3 

checking which template to use... darwin 

checking whether to build with 64-bit integer date/time support,.. 


| checking whether to build with recode support... no 


checking whether NLS is wanted... no 

checking for default port number... 5432 

checking for default soft Limit on number of connections... 32 
checking for gcc... gcc 

checking for C compiler default output... a.out 
checking whether the C compiler works... yes 

checking whether we are cross compiling... no 

checking for suffix of executables... 

checking for suffix of object files... o 

checking whether we are using the GNU C compiler... yes 
checking whether gcc accepts -g... yes 

configure: using CFLAGS=-g -02 

checking whether the C compiler still works... yes 


Your software configures 
for compilation. 


Type ./configure if you 
have installed, or /configure 
--without-readline if you have 
not, and press Return. 


DEVELOP UNIX APPLICATIONS 


To allow other users to use your new database To add the man pages for your new 


software, you must enable them from the postgres database software to your search list, 
account. Otherwise, the users will get an error of this append /usr/local/pgsql/man to your 

type: psql: FATAL: user "kbartlett" MANPATH environment variable. This path 
does not exist. To enable a new user, use the may contain a number of directories 

su command to access the postgres account by typing | separated by colons. The following 

su - postgres. Then connect to the database using the example adds all the man directories 

psql testdb command. After you establish the shown to your search path for man pages. 
connection, add the user witha create user 

username; command, where you replace username | Example: 

with the username of the user you want to enable. setenv MANPATH /sw/share/man: /usr/local/ 


man: /usr/share/man:/usr/local/pgsql/man « 


After connecting to PostgreSQL to create tables or 
run queries, you need to disconnect from the 
database. To do this, type \q. This command returns 
you to your normal system prompt. 


& Terminal File Edit Scroliback Font Window Help - Terminal File Edit Scrollback Font Window Help 


igos.h | [ [Uferro:-7 users] sudo make install] 
config.status: linking ./src/makefiles/Makefile, darwin to src/Makefile.po ~ : 

] gzip -d -c postgres.tar.gz | ( cd /usr/lecal/pgsql/doc/html && /usr/bin/t 
ar xf - ) ; 
for file in manl/*.1 man7/*,7 ; do \ 


gzip -d -c man.tar.gz | /usr/bin/tar xf - /bin/sh ../config/install~sh -c -m 644 $file /usr/local/pgsql/man/$fitef 
for file in mani1/*.1; do \ HE exit; \ 4 


my $file $file.bak && \ done 
sed -e ‘s/\\FRCLIAN\FRC7)/" S$file.bak >$file && \ 
cm -f $file.bak 11 exit; \ 


. /config/mkinstalldirs man7 
mkdir man7 
for file in manl/*.1; do \ 
sed -e '/A\.TH/s/*1L"/"7"7" oN 
~e@ "S/N\NERCLOAAVERC737" \ 
$file >man7/*basename $file | sed 's/.1$/.7/"° '} exit; \ 
done 
make ~C src all 
make -C port all 
make[2}; Nothing to be done for ‘all’. 
make -C backend all 


Type make and press The software begins to Type sudo make install and Your software compiles 
Return. compile. "press Return. and installs. 
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RUN A DATABASE ON MAC OS X (CONTINUED) 


hile it might not be immediately obvious, a 
W database is a form of server — a process that 

supplies information to clients. After a database is 
created with createdb, initiated with initdb, and 
populated with tables and data, the database is ready to 
start answering queries. Most databases run all the time 
whether or not anyone is using them. 


When you start a psq1 session and connect to a database, 
you are acting as a client of the database. You can select 
data from tables by searching for certain values and by 
restricting what you want to see from these tables by 
columns as well. 


PostgreSQL, like most modern databases, is a relational 
database. That term implies that all data are stored in a 
uniform manner — in tables. Unlike a hierarchical database, 
in which data elements have parent/child relationships, 
relational databases have no such relationships. Instead, 
data of all kinds is stored in tables and all records are 
accessed in the same manner. 


RUN A DATABASE ON MAC OS X (CONTINUED) 


@ Terminal File €dit Scroiiback Font Window Help & 


‘ Byp2 — 


username: postgres 

full name: postgres user 

uid: 23456 

shell: /bin/tcsh 

password; 

Changing password for postgres. 
New password: 

Retype new password: 


Note: To complete step 7, you must 
have already created an adduser 
script. If not, see Chapter 11. 


[4 Type adduser and press 
Return. 


[| lferro:~] user%| sudo mkdir /usr/local /pgsql/data 


/usrAocalV/pgsqV/data 
and press Return. 


The basic query command is select. When you issue a query 
that selects phone from contacts, phone is a column ina 
table named contacts. If you select phone from contacts 
where areacode is equal to 415, you are listing your 
contacts in San Francisco. In this case, you are asking to 
view one particular column from particular rows in your 
table of contacts. 


While SQL, the standard language used for relational 
databases, is not exactly free-flowing English, it is still easy 
to use and understand. The command select phone 
from contacts where areacode=415; is about as 
close to flowing speech as computer syntax comes. 


SQL also allows you insert data into tables with insert, 
remove data from tables with delete, modify data in 
tables with update and sort data with order by. 


Terminal File 


Edit Scroiiback Font Window Help 


%| sudo chown postgres /usr/Local/pgsql/data 


Type sudo mkdir ui) Type su - postgres and 
press Return, then type the 
postgres password at the 


ts 
Type sudo chown postgres pene 


/usr/ocaVpgsq\/data. 


DEVELOP UNIX APPLICATIONS 


You can get help during your psq]1 session by typing \?. 
When you enter this command, a list of slash commands, 
such as \1 for creating a list of your databases, appears. 
You can use the \h command to get help on a particular 
command. For example, typing \h select describes the 
syntax and use of the select command. 


To exit your psql session, type \q. 


SQL syntax provided by the help function will display 
optional portions of a command inside square brackets. If 
you type \h modify, for example, you will notice that the 
word ONLY appears within square brackets — [ ONLY ]. 
This part of the command is, therefore, optional. Similarly, 
[ WHERE condition ] means that you can optionally 
specify a condition, such as where areacode=415. 


Terminal File Edit Scroliback Font Window Help 


fusr/iocal/pgsal/bin/initds -D /usr/local/posqt/data 


The Files belonging to this database system will be owned by user “postgr ’ 


es” 
This user must also own the server process. 


The database cluster will be initialized with locale C. 


Fixing permissions on existing directory /usr/local/pgsql/data... ok 
creating directory /usr/local/pgsql/data/base... ok 

creating directory /usr/local/pgsql/data/global... ok 

creating directory /usr/local/pgsql/data/pg_xlog... ok 

creating directory /usr/local/pgsql/data/pg_clog... ok 

creating templatel database in /usr/lLocal/pgsql/data/base/1... ok 
creating configuration files... ok 

initializing pg_shadow.,. ok 

enabling unlimited row size for system tables... ok 

initializing pg_depend... ok 

creating system views... ok 

leading pg_description... ok 

creating conversions... ok 

setting privileges on built-in objects... ok 

vacuuming database templatel... ok 


Type /usrAocal/pgsqVbin/ 
initdb -D /usr/Aocal/pgsqi/data 
and press Return. 
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su-2.85a$] nohup Pe paca fs /bin/postmaster -D /usr/loca 7pgsqi/data | % : 
r 
(1] 8496 ; 
su~2.05a$ 

CREATE DATABASE 

su-2.0@5a$|psql tesidb 

Welcome to psqi 7.3, the PostgreSQL interactive terminal. 


Type: \copyright for distribution terms 
\h for help with SQL commands 
\? for help on internal slash fonmonds 
\g or terminate with semicolon] to execute query 
\g to quit 


testdb=# [] 


Type nohup /usrfocal/ 
pgsqUbin/postmaster -D 
/usr/Aocal/pgsql/data </dev/null 
>>server.log 2>&1 </dev/null & 
and press Return. 


LJ Type createdb testdb and 
press Return. 


@ Your database is created. 


usJ Type psql testdb and press 


@ Your database service Return. 


starts. Mi You connect to 
the database. 


ou can issue SQL commands to your PostgreSQL 


database. To use all of the features of your database 

software, you need to learn a number of SQL 
commands. In particular, you need to learn how to create 
tables, insert and remove records from these tables, and run 
queries to extract information from these tables. 


The command for creating a table is create table 
tablename. When you define a table, you need to specify 
the number of columns you want to add. For example, the 
SQL command for adding a book table to the database may 
look like this: 


create table books ( 


author varchar (32), 
title varchar (64), 
publisher varchar (16), 
pubyear ant; 

ISBN varchar (13) 


Edit Scroliback 


Font Window Help 


Welcome to psqi 7.3, the PostgreSQL interactive terminal. 


\copyright for distribution terms 
\h for help with SQL commands 

\? for help on internal slash commands 

\g or terminate with semicolon to execute query 
\q to quit 


create table pets 
name varcharci2), 
type varchar(6), 


Type: 


testdb=# 
testdb(# 


a) Type psq! testdb and press 
Return. 


<4] Type name varchar(12), 
and press Return. 


4 Type type varchar(6), and 
press Return. 


&’4| Type create table pets ( 
and press Return. 


WRITE SQL COMMANDS 


You define each column in the table as having a particular 
type. Most of these types are character fields of a specified 
length. After you define a table, you can add records to it. 
You can do this one record at a time, or you can bulk load 
a table from a flat text file. To add a single record, you can 
identify the table and the value you want to assign to each 
column in the new record. For example, you may say 
insert into books values('Paul Whitehead 
and Eric Kramer','Your visual blueprint 

for building Perl scripts', 'Wiley 
Publishing' , 2000, '0-7645-3478-5') ; paying 
particular attention to the semicolon at the end. 


You can list the contents of the books table in its entirety 
with the command select * from books; or you can 
select some of the records by running a select command 
with a where clause. For example, to list the titles of the 
books in your table that were published in the year 2000, 
you can type select title from books where pubyear = 2000;. 


@ Terminal File Edit Scroilback Font Window Help 


Welcome to psql 7,3, the PostgreSQL interactive terminal. 


Type: \copyright for distribution terms 
\h for help with SQL commands 
\? for help an internat slash commands 
\g or terminate with semicolon to execute query 
\q to quit 


testdb=# create table pets ( 
testdb(# name vorchar(i2), 
testdbh(4 type varchar(6), 


[[testdb# age Int, | 


testdb# [fixed varchar(1) 
testdbc# 
CREATE TABLE 


EH Type age int, and press 
Return. 


EM Type ); and press Return. 


= Your table is added to the 
| Type fixed varchar(1) and database. 


press Return. 


DEVELOP UNIX APPLICATIONS 


You can insert records into a PostgreSQL table by typing an 
insert command for each record, or you can create a text file 
containing the commands and load that file. To create a table and 
load it from a text file, you can type the table create 
command along with each of the insert commands into a file, 
such as pets.sql. 


Example: 
create table pets name varchar(12), type varchar(6), age int, fixed varchar(1)); 
insert into pets values('Amaranthe’,'cat',1,'y'); 

insert into pets values('Raven','dog',6,'y'); 

insert into pets values('Maize','cat',.5,'n'}; 


You can enter the following to load the data into the database: 


psql -d testdb -f£ /Users/user/pets.sql 


To count the records in a table, you can use an SQL count command. 
TYPE THIS: RESULT: 


select count(*) from pets; 


Terminal File Edit Scroliback Font Window tHeip - oa File Edit 


Scroliback Font 


Window Help 


testdb=# 
testdb=# 
i testdb=# 
insert into pets values( Maize’ ,'’cat",.5,'n’); : testdb=# 
testdb=# 
testdb=# 


| type {| oge | cael t testdb=# 


Raven i Amaranthe | cat 
Maize : Maize | cat | 
H (2 rows) 


select * from pets where type="cat'; 
i type | age | fixed 


testdb=# 
testdb=# 
testdbat# 
testdb=# 
testdb=# 
testdbea# 
testdb=# [] 


Type insert into pets 
values('Amaranthe','cat',1,'y'); 
and press Return. 


Li Type insert into pets 
values('Maize','cat',.5,'n'); 
and press Return. 


ux4 Type select * from pets The database selects and 
where type='cat'; and press prints the data you request. 
Return. 


Type insert into pets 
values('Raven','dog',6,'y'); 
and press Return. 


uu!) Type select * from pets; 
and press Return. 


ui Type select name from pets 
where fixed='n'; and press 


Return. 
The database server 


displays the contents of 
your table. 


UNIX FOR MAC 


ACCESS DATABASES FROM PHP 


include this information in your Web pages. While 

the setup required to provide information stored in a 
postgres database on a Web page is not intuitive, you can 
provide this functionality when you have the proper tools. 


Y ou can access data in your databases from PHP and 


You need to install PostgreSQL on your server. You also need 
to use a Web server that supports PHP — for example, an 
installation of Apache that supports PHP dynamically or 
statically. In addition, your PHP build must support 
PostgreSQL; that is, you must build it with the -with- 
pgsql1 configuration parameter. Lastly, for a Web site to use 
PostgreSQL commands, the database must be running. 


When you are sure that you have these prerequisites, you 
can create a Web page that incorporates information from 
your database. The first step is to identify the database that 
you are using, as follows: 


ACCESS DATABASES FROM PHP 


<head><title>test PHP and PostgreSQL</titLe></head> 
[ebody>T]] 


Get Help WriteOut Bh Read Filemil Pv Pg Cut Text Cur Pos 
Exit Justify jj Where is + Pg UnCut Texii To Spell 


El Start the Pico editor 

to create a file named 
/sw/apache/htdocs/testpg.php 
and press Return. 


<i Type <head><title>test 
PHP and PostgreSQL 
</title></head> and 

press Return. 


@ The Pico screen appears. “4 Type <body> and press 


Return once more. 
# Type <html> and press 


Return. 
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<0 

Shost = "localhost"; 
Suser = "postgres"; 
Spass = "dbacct"; 


Sdb = "testdb"; 


You can then open a connection to the database with a 
command such as Sconnect = pg_connect ("host= 
Shost dbname=Sdb user=$Suser password=Spass 
password=$pass") ;. You can then determine if your 
connection is successful by testing the $connect value. 


Next, you can create the query that you want to run — for 
example, $query = "select * from pets"; — and 
execute that query with a command such as $result = 
pg_query($connect, $query) or die("Query 
failed: $query") ;. If your query is successful, the 
command stores the data that you just fetched in $result. 


You can now decide how to process and display the data 
that the command returns from the database. 


pass = “dbacct™,; 
$db = "testdb”; 


mn Get Help Mi WriteQut Read Fil 2 Cut Text Cur Pos 
Exit mm) Justify Where is UnCut Te To Spell 


La Type $pass = "dbacct"; 
and press Return, then type 
$db = "testdb"; and press 
Return. 


Type <? and press Return. 


Type $host = "localhost"; 
and press Return, then type 
$user = "postgres"; and press 
Return. 
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<html> 
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DEVELOP UNIX APPLICATIONS 


This example comprises the complete PHP 
file for testing your database accessibility. 


Example: 
<html> 


<head><title>test PHP and PostgreSQL</title></head> 


<body> 
<p 


// database access parameters 


"localhost"; 
"postgres"; 
"dbacct.”- 
"testdb"; 


Shost = 
Suser = 
Spass = 
$db = 


// open a connection 


Sconnect = pg_connect 


password=$pass") ; 
if (!$comnect) { 


die("could not open a connection to db server"); } 


// generate and execute query 


$query = 
oe 


= po_ 
query" 2 


// get number of rows 
pg_num_rows ($result) ; 


Srows = 


"select * from pets"; 


ery(S$connect, $query) or die("error in query: 
pg_ltast_error($connection) }); 


echo "There are Srows records in the pets db"; 


// close db connection 


pg_close($connect) ; 
?> 

</body> 

</html> 


Window Heip 


<head><title>test PHP and PostgreSQL</title></head> 


"Localhost”; 

"postgres"; 

"dbacct"; 
“testdb" ; 


$connect = pg_connect(“host=$host dbname=$db user=$user 


| password=$pass”); 


if Ci$connect){die("could not open a connection to db server"); 


// generate and execute quer 


$query = “select * from pets"; 


Get Help WriteOut 
Exit Justify 


K:3] Type $connect = 
pg_connect ("host=$host 
dbname=$db user=$user 
password=$pass"); and 
press Return. 


kJ] Type if (!$connect) 

{ die("could not opena 
connection to db server"); 
} and press Return. 


Read Filegg 


Cut Text a Cur Pos 
UnCut Texiii To Spell 


¥ Pg 
t Pg 


uj Type // generate and 
execute query and press 
Return. 


ui Type $query = "select * 
from pets"; and press Return. 
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$rows=pg_num_rows ($result); 
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Cae 


("host=Shost dbname=$db user=Suser 


Window Help 


echo “There are $rows records in the pets db”: 


pg_close($conrnect); 
?> 


</body> 


ae Get Help WriteOut MM Read Fil 
By Exit Justify i Where is 


12 Type $rows = 
pg_num_rows($result); 
and press Return. 


LEJ Type echo "There are 
$rows records in the pets db"; 
and press Return. 


ik} Type pg_close($connect); 
and press Return, then type 
?> and press Return. 


Prev Pg 


me Cut Text Cur Pos 
Next Pg 


ms) UnCut Te: To Spell 


LE} Type </body> and press 
Return, then type </html>. 


FS Save your file. 


@ Your test page is ready 
to run. 


APPENDIX 
WHAT'S ON THE CD-ROM 


useful files and programs. Before installing any of the 

programs on the disc, make sure that you do not 
already have a newer version of the program already 
installed on your computer. For information on installing 


T= CD-ROM included in this book contains many 


SYSTEM REQUIREMENTS 


To use the contents of the CD-ROM, your computer must 
have the following hardware and software: 


For Macintosh: 


¢ Mac OS X v.10.2 or higher with a 400 MHz or faster CPU 


¢ Atleast 256MB of total RAM installed on your computer; 
for best performance, we recommend at least 512MB 


e Anetwork card 
e ACD-ROM drive 


ACROBAT VERSION 


The CD-ROM contains an e-version of this book that you 
can view and search using Adobe Acrobat Reader. You 
cannot print the pages or copy text from the Acrobat files. 
The CD-ROM includes an evaluation version of Adobe 
Acrobat Reader. 


INSTALLING AND USING THE SOFTWARE 


For your convenience, the software titles appearing on the 
CD-ROM are listed alphabetically. Some software provided 
on this CD may require additional components for 
installation. See the ReadMe file and links pages on 

the CD for additional information. 


AbiWord 

For Unix, Linux, and Windows. GNU Freeware/Open 
Source. Requires X Windows. AbiWord is a cross-platform 
word-processing program that enables you to perform the 
same task as Microsoft Word. From AbiSource c/o 
SourceGear Corporation, www.abisource.com. 


Acrobat Reader 

For Macintosh and Windows. Freeware. Adobe Acrobat 
Reader allows you to view the online version of this book. 
For more information on using Acrobat Reader, see the 
section "Using the E-Version of the Book" in this Appendix. 
From Adobe Systems, www.adobe.com. 


Ee | 


different versions of the same program, contact the 
program's manufacturer. For the latest and greatest 
information, please refer to the ReadMe file located at the 
root level of the CD-ROM as well as the manufacturer's 
Web site. 


Chimera 

For Mac OS X. Freeware/Open Source. Chimera is a 
browser for Jaguar, Mac OS X v.10.2. From The Mozilla 
Organization, www.mozilla.org/projects/chimera. 


Fink 

For Mac OS X. Freeware/Open Source. Fink enables Mac 
OS X to import and fix open source Unix software. From 
The Fink Project, http://fink.sourceforge.net. 


GIMP 

For Unix, Mac OS X, and Windows. GNU Freeware/Open 
Source and Binary. Requires X Windows. The GIMP is the 
GNU Image Manipulation Program for photo retouching, 
image composition, and image authoring. From GNOME, 
www.gimp.org. 


GNOME Core 

For Unix and Linux. Freeware/Open Source. Requires X 
Windows. GNOME Core contains the core components 
needed to run the GNOME desktop environment. From 
GNOME, www.gnome.org. 


GnuCash 

For Mac OS X and Linux. GNU Freeware/Open Source. 
GnuCash is a finance software that enables you to manage 
your bank accounts, stocks, income, and expenses, and 
more. From The GnuCash Project, www.gnucash.org. 


KDEbase 

For Unix, Linux, and Solaris. Freeware/Open Source. 
Requires X Windows. KDEbase contains the basic 
applications that are used with the KDE desktop 
environment. From The KDE Project, www.kde.org. 


KDElibs 

For Unix systems. Freeware/Open Source. Requires X 
Windows. KDElibs contains libraries needed by the K 
Desktop Environment. From The KDE Project, www.kde.org. 
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Lynx 

For Unix, VMS, Windows 95 and higher. GNU 
Freeware/Open Source and Binary. Lynx is a text-based 
Internet Web browser originally developed at the University 
of Kansas. http://lynx.browser.org. 


Mozilla 

For Unix and Linux systems. Freeware/Open Source. Mozilla 
is an open-source Web browser and toolkit. From The 
Mozilla Organization, www.mozilla.org. 


OpenOffice.org 

For alt platforms. Freeware/Open Source. Requires X 
Windows. OpenOffice.org is an office suite that will run on 
all major platforms. From OpenOffice.org, 
www.openoffice.org. 


PostgreSQL 

For Unix and Linux systems. Freeware/Open Source. An 
advanced object-relational database management system 
(ORDBMS) with utilities needed to create and maintain the 
database server. From PostgreSQL, www.postgresql.org. 


Screen 

For Unix. GNU Freeware/Open Source. Screen is a utility 
that allows you to have multiple logon screens in a single 
terminal. From The GNU Project, www.gnu.org. 


Vim 

For Unix, Linux, and Mac OS X. Freeware/Open Source. vim 
(Visual editor iMproved) is an enhanced text editor. From 
The VIM Group, www.vim.org. 


XFree&6 

For Unix, Linux, Solaris, Mac OS X. Freeware/Open Source. 
XFree86 is an X Windows server. It provides a client/server 
interface between display hardware and the desktop 
environment, while providing both the windowing 
infrastructure and a standardized application interface. 
From The XFree86 Project, Inc, www.xfree86.org. For Mac 
OS X ports, go to sourceforge.netprojectsXonX. 


Xmms 
For Unix systems. Freeware/Open Source. X MultiMedia 
System (Xmms) is a multimedia player that supports MPEG, 


WAV, and AU formats. From 4Front Technologies, 
www.xmms.org. 


TROUBLESHOOTING 


The programs on the CD-ROM should work on computers 
with the minimum of system requirements. However, some 
programs may not work properly. 


Many of the tools on the CD require that you first install an 
X Windows server, such as the XFree86 software included 
on the CD. The two most likely problems for the programs 
not working properly include not having enough memory 
(RAM) for the programs you want to use, or having other 
programs running that affect the installation or running of a 
program. If you receive error messages such as Not enough 
memory or Setup cannot continue, try one or more of the 
methods below and then try using the software again: 


¢ Turn off any anti-virus software 
¢ Close all running programs 


e Have your local computer store add more RAM to your 
computer 


Mac OS X requires more memory than previous versions of 
Mac OS. For acceptable performance, you should run at 
least 256MB of RAM. 


Execution of programs that you install may depend on 
having the proper environment. Your search path should 
include the directory in which your software has been 
installed, for example, /sw/bin or /usr/local/bin. You may 
also have to adjust your dynamic library search path to 
enable these applications to find and use the runtime 
libraries they need. The environment variable 
DYLD_LIBRARY_PATH may have to be updated to include 
directories such as /sw/lib or /usr/local/lib. 


In addition, any application that is not installed with an 
installer program will open slowly the first time it is run. 
This is normal. 


If you still have trouble installing the items from the 
CD-ROM, call the Wiley Publishing Customer Service 
phone number: 800-762-2974 (outside the U.S.: 
317-572-3994). You can also contact Wiley Publishing 
Customer Service by e-mail at techsupdum@wiley.com. 
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USING THE E-VERSION OF THE BOOK 


ou can view Unix for Mac: Your visual blueprint to 

maximizing the foundation of Mac OS X on your 

screen using the CD-ROM included at the back of this 
book. The CD-ROM allows you to search the contents of 
each chapter of the book for a specific word or phrase. The 
CD-ROM also provides a convenient way of keeping the 
book handy while traveling. 


You must install Adobe Acrobat Reader on your computer 
before you can view the book on the CD-ROM. This 
program is provided on the disc. Acrobat Reader allows you 
to view Portable Document Format (PDF) files, which can 
display books and magazines on your screen exactly as they 
appear in printed form. 


USING THE E-VERSION OF THE BOOK 


To view the contents of the book using Acrobat Reader, 
insert the CD-ROM into your drive. The autorun interface 
will appear. Navigate to the eBook, and open the book.pdf 
file. You may be required to install Acrobat Reader 5.0 on 
your computer, which you can do by following the simple 
intallation instructions. If you choose to disable the autorun 
interface, you can open the CD root menu and open the 
Resources folder, then open the eBook folder. In the 
window that appears, double-click the eBook.pdf icon. 
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WHAT'S ON THE CD-ROM 


To install Acrobat Reader, insert the CD-ROM 
disc into a drive. In the screen that appears, click 
Software. Click Acrobat Reader and then click 
Install at the bottom of the screen. Then follow 
the instructions on your screen to install the 
program. 


You can make searching the book more 
convenient by copying the .pdf files to your own 
computer. Display the contents of the CD-ROM 
disc and then copy the PDFs folder from the CD 
to your hard drive. This allows you to easily 
access the contents of the book at any time. 
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Acrobat Reader is a popular and useful program. 
There are many files available on the Web that are 
designed to be viewed using Acrobat Reader. 
Look for files with the .pdf extension. For more 
information about Acrobat Reader, visit the Web 
site at www.adobe.com/products/ 
acrobat/readermain.html. 
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_ WILEY PUBLISHING, INC. 
~. END-USER LICENSE AGREEMENT 


~~ READ THIS. You should carefully read these terms and 


conditions before opening the software packet(s) included 
with this book Unix for Mac: Your visual blueprint to 
maximizing the foundations of Mac OS X. This is a license 
agreement "Agreement" between you and Wiley Publishing, 
Inc. "WPI". By opening the accompanying software 
packet(s), you acknowledge that you have read and accept 
the following terms and conditions. !f you do not agree and 
do not want to be bound by such terms and conditions, 
promptly return the Book and the unopened software 
packet(s) to the place you obtained them for a full refund. 


1. License Grant. 


WPI grants to you (either an individual or entity) a 
nonexclusive license to use one copy of the enclosed 
software program(s) (collectively, the "Software," solely for 
your own personal or business purposes on a single 
computer (whether a standard computer or a workstation 
component of a multi-user network). The Software is in use 
on a computer when it is loaded into temporary memory 
(RAM) or installed into permanent memory (hard disk, 
CD-ROM, or other storage device). WPI reserves all rights 
not expressly granted herein. 


2. Ownership. 


WPI is the owner of all right, title, and interest, including 
copyright, in and to the compilation of the Software 
recorded on the disk(s) or CD-ROM "Software Media". 
Copyright to the individual programs recorded on the 
Software Media is owned by the author or other authorized 
copyright owner of each program. Ownership of the 
Software and all proprietary rights relating thereto remain 
with WPI and its licensers. 


3. Restrictions on Use and Transfer. 


(a) You may only (i) make one copy of the Software for 
backup or archival purposes, or (ii) transfer the Software to 
a single hard disk, provided that you keep the original for 
backup or archival purposes. You may not (i) rent or lease 
the Software, (ii) copy or reproduce the Software through a 
LAN or other network system or through any computer 
subscriber system or bulletin-board system, or (iii) modify, 
adapt, or create derivative works based on the Software. 


(b) You may not reverse engineer, decompile, or 
disassemble the Software. You may transfer the Software 
and user documentation on a permanent basis, provided 
that the transferee agrees to accept the terms and 
conditions of this Agreement and you retain no copies. If 
the Software is an update or has been updated, any transfer 
must include the most recent update and all prior versions. 


4. Restrictions on Use of Individual Programs. 


You must follow the individual requirements and 
restrictions detailed for each individual program in the 
What's on the CD-ROM appendix of this Book. These 
limitations are also contained in the individual license 
agreements recorded on the Software Media. These 
limitations may include a requirement that after using the 
program for a specified period of time, the user must pay a 
registration fee or discontinue use. By opening the Software 
packet(s), you will be agreeing to abide by the licenses and 
restrictions for these individual programs that are detailed 
in the What’s on the CD-ROM appendix and on the 
Software Media. None of the material on this Software 
Media or listed in this Book may ever be redistributed, in 
original or modified form, for commercial purposes. 


5. Limited Warranty. 


(a) WPI warrants that the Software and Software Media 
are free from defects in materials and workmanship under 
normal use for a period of sixty (60) days from the date of 
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purchase of this Book. If WPI receives notification within 
the warranty period of defects in materials or workmanship, 
WPI will replace the defective Software Media. 


(b) WPIAND THE AUTHOR OF THE BOOK DISCLAIM ALL 
OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
WITHOUT LIMITATION IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE, WITH RESPECT TO THE SOFTWARE, THE 
PROGRAMS, THE SOURCE CODE CONTAINED THEREIN, 
AND/OR THE TECHNIQUES DESCRIBED IN THIS BOOK. 
WPI DOES NOT WARRANT THAT THE FUNCTIONS 
CONTAINED IN THE SOFTWARE WILL MEET YOUR 
REQUIREMENTS OR THAT THE OPERATION OF THE 
SOFTWARE WILL BE ERROR FREE. 


(c) This limited warranty gives you specific legal rights, and 
you may have other rights that vary from jurisdiction to 
jurisdiction. 


6. Remedies. 


(a) WPI's entire liability and your exclusive remedy for 
defects in materials and workmanship shall be limited to 
replacement of the Software Media, which may be returned 
to WPI with a copy of your receipt at the following address: 
Software Media Fulfillment Department, Attn.: Unix for 
Mac: Your visual blueprint to maximizing the foundation of 
Mac OS X, Wiley Publishing, Inc., 10475 Crosspoint Blvd., 
Indianapolis, IN 46256, or call 1-800-762-2974. Please allow 
four to six weeks for delivery. This Limited Warranty is void 
if failure of the Software Media has resulted from accident, 
abuse, or misapplication, Any replacement Software Media 
will be warranted for the remainder of the original warranty 
period or thirty (30) days, whichever is longer. 


(b) In no event shall WPI or the author be liable for any 
damages whatsoever (including without limitation damages 
for loss of business profits, business interruption, loss of 
business information, or any other pecuniary loss) arising from 
the use of or inability to use the Book or the Software, even if 
WPI has been advised of the possibility of such damages. 


(c) Because some jurisdictions do not allow the exclusion 
or limitation of liability for consequential or incidental 
damages, the above limitation or exclusion may not apply 
to you. 


7. U.S. Government Restricted Rights. 


Use, duplication, or disclosure of the Software for or on 
behalf of the United States of America, its agencies and/or 
instrumentalities "U.S. Government” is subject to 
restrictions as stated in paragraph (c)(1)(ii) of the Rights in 
Technical Data and Computer Software clause of DFARS 
252.227-7013, or subparagraphs (c) (1) and (2) of the 
Commercial Computer Software - Restricted Rights clause 
at FAR 52.227-19, and in similar clauses in the NASA FAR 
supplement, as applicable. 


8. General. 


This Agreement constitutes the entire understanding of the 
parties and revokes and supersedes all prior agreements, 
oral or written, between them and may not be modified or 
amended except in a writing signed by both parties hereto 
that specifically refers to this Agreement. This Agreement 
shall take precedence over any other documents that may 
be in conflict herewith. If any one or more provisions 
contained in this Agreement are held by any court or 
tribunal to be invalid, illegal, or otherwise unenforceable, 
each and every other provision shall remain in full force and 
effect. 


APPENDIX 


GNU GENERAL PUBLIC LICENSE 
Version 2, June 1991 


Copyright © 1989, 1991 Free Software Foundation, Inc. 
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA 


Everyone is permitted to copy and distribute verbatim 
copies of this license document, but changing it is not 
allowed. 


PREAMBLE 


The licenses for most software are designed to take away 
your freedom to share and change it. By contrast, the GNU 
General Public License is intended to guarantee your 
freedom to share and change free software—to make sure 
the software is free for all its users. This General Public 
License applies to most of the Free Software Foundation's 
software and to any other program whose authors commit 
to using it. (Some other Free Software Foundation software 
is covered by the GNU Library General Public License 
instead.) You can apply it to your programs, too. 


When we speak of free software, we are referring to 
freedom, not price. Our General Public Licenses are 
designed to make sure that you have the freedom to 
distribute copies of free software (and charge for this 
service if you wish), that you receive source code or can get 
it if you want it, that you can change the software or use 
pieces of it in new free programs; and that you know you 
can do these things. 


To protect your rights, we need to make restrictions that 
forbid anyone to deny you these rights or to ask you to 
surrender the rights. These restrictions translate to certain 
responsibilities for you if you distribute copies of the 
software, or if you modify it. 


For example, if you distribute copies of such a program, 
whether gratis or for a fee, you must give the recipients all 
the rights that you have. You must make sure that they, too, 
receive or can get the source code. And you must show 
them these terms so they know their rights. 


We protect your rights with two steps: (1) copyright the 
software, and (2) offer you this license which gives you legal 
permission to copy, distribute and/or modify the software. 


Also, for each author’s protection and ours, we want to 
make certain that everyone understands that there is no 
warranty for this free software. If the software is modified 
by someone else and passed on, we want its recipients to 
know that what they have is not the original, so that any 
problems introduced by others will not reflect on the 
original authors' reputations. 


Finally, any free program is threatened constantly by 
software patents. We wish to avoid the danger that 
redistributors of a free program will individually obtain 
patent licenses, in effect making the program proprietary. 
To prevent this, we have made it clear that any patent must 
be licensed for everyone's free use or not licensed at all. 


The precise terms and conditions for copying, distribution 
and modification follow. 


Terms and Conditions for Copying, 


Distribution and Modification 

This License applies to any program or other work 
which contains a notice placed by the copyright holder 
saying it may be distributed under the terms of this General 
Public License. The "Program", below, refers to any such 
program or work, and a "work based on the Program" 
means either the Program or any derivative work under 
copyright law: that is to say, a work containing the Program 
or a portion of it, either verbatim or with modifications 
and/or translated into another language. (Hereinafter, 
translation is included without limitation in the term 
"modification".) Each licensee is addressed as "you". 

Activities other than copying, distribution and 
modification are not covered by this License; they are 
outside its scope. The act of running the Program is not 
restricted, and the output from the Program is covered only 
if its contents constitute a work based on the Program 
(independent of having been made by running the 
Program). Whether that is true depends on what the 
Program does. 


1. You may copy and distribute verbatim copies of the 
Program's source code as you receive it, in any medium, 
provided that you conspicuously and appropriately publish 
on each copy an appropriate copyright notice and 


WHAT'S ON THE CD-ROM 


disclaimer of warranty; keep intact all the notices that refer 
to this License and to the absence of any warranty; and give 
any other recipients of the Program a copy of this License 
along with the Program. 

You may charge a fee for the physical act of transferring 
a copy, and you may at your option offer warranty 
protection in exchange for a fee. 


2. You may modify your copy or copies of the Program or 
any portion of it, thus forming a work based on the 
Program, and copy and distribute such modifications or 
work under the terms of Section 1 above, provided that you 
also meet all of these conditions: 

(a) You must cause the modified files to carry prominent 
notices stating that you changed the files and the date of 
any change. 

(b) You must cause any work that you distribute or publish, 
that in whole or in part contains or is derived from the 
Program or any part thereof, to be licensed as a whole at no 
charge to all third parties under the terms of this License. 
(c) If the modified program normally reads commands 
interactively when run, you must cause it, when started 
running for such interactive use in the most ordinary way, to 
print or display an announcement including an appropriate 
copyright notice and a notice that there is no warranty (or 
else, saying that you provide a warranty) and that users may 
redistribute the program under these conditions, and telling 
the user how to view a copy of this License. (Exception: if 
the Program itself is interactive but does not normally print 
such an announcement, your work based on the Program is 
not required to print an announcement.) 


These requirements apply to the modified work as a 
whole. If identifiable sections of that work are not derived 
from the Program, and can be reasonably considered 
independent and separate works in themselves, then this 
License, and its terms, do not apply to those sections when 
you distribute them as separate works. But when you 
distribute the same sections as part of a whole which is a 
work based on the Program, the distribution of the whole 
must be on the terms of this License, whose permissions for 
other licensees extend to the entire whole, and thus to each 
and every part regardless of who wrote it. 


(a) Thus, it is not the intent of this section to claim rights 
or contest your rights to work written entirely by you; 
rather, the intent is to exercise the right to control the 
distribution of derivative or collective works based on the 
Program. 

In addition, mere aggregation of another work not 
based on the Program with the Program (or with a work 
based on the Program) on a volume of a storage or 
distribution medium does not bring the other work under 
the scope of this License. 


3. You may copy and distribute the Program (or a work 
based on it, under Section 2) in object code or executable 
form under the terms of Sections 1 and 2 above provided 
that you also do one of the following: 

(a) Accompany it with the complete corresponding 
machine-readable source code, which must be distributed 
under the terms of Sections 1 and 2 above on a medium 
customarily used for software interchange; or, 

(b) Accompany it with a written offer, valid for at least 
three years, to give any third party, for a charge no more 
than your cost of physically performing source distribution, 
a complete machine-readable copy of the corresponding 
source code, to be distributed under the terms of Sections 
1 and 2 above on a medium customarily used for software 
interchange; or, 

(c) Accompany it with the information you received as to 
the offer to distribute corresponding source code. (This 
alternative is allowed only for noncommercial distribution 
and only if you received the program in object code or 
executable form with such an offer, in accord with 
Subsection b above.) 

The source code for a work means the preferred form 
of the work for making modifications to it. For an 
executable work, complete source code means all the 
source code for all modules it contains, plus any associated 
interface definition files, plus the scripts used to control 
compilation and installation of the executable. However, as 
a special exception, the source code distributed need not 
include anything that is normally distributed (in either 
source or binary form) with the major components 
(compiler, kernel, and so on) of the operating system on 
which the executable runs, unless that component itself 
accompanies the executable. 
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If distribution of executable or object code is made 
__ by offering access to copy from a designated place, then 
> offering equivalent access to copy the source code from the 
~ game place counts as distribution of the source code, even 
though third parties are not compelled to copy the source 
along with the object code. 


4. You may not copy, modify, sublicense, or distribute the 
Program except as expressly provided under this License. 
Any attempt otherwise to copy, modify, sublicense or 
distribute the Program is void, and will automatically 
terminate your rights under this License. However, parties 
who have received copies, or rights, from you under this 
License will not have their licenses terminated so long as 
such parties remain in full compliance. 


5. You are not required to accept this License, since 

you have not signed it. However, nothing else grants you 
permission to modify or distribute the Program or its 
derivative works. These actions are prohibited by law if 
you do not accept this License. Therefore, by modifying 

or distributing the Program (or any work based on the 
Program), you indicate your acceptance of this License 

to do so, and all its terms and conditions for copying, 
distributing or modifying the Program or works based on it. 


6. Each time you redistribute the Program (or any work 
based on the Program), the recipient automatically receives 
a license from the original licensor to copy, distribute or 
modify the Program subject to these terms and conditions. 
You may not impose any further restrictions on the 
recipients' exercise of the rights granted herein. You are not 
responsible for enforcing compliance by third parties to this 
License. 


7. If, as a consequence of a court judgment or allegation 
of patent infringement or for any other reason (not limited 
to patent issues), conditions are imposed on you (whether 
by court order, agreement or otherwise) that contradict the 
conditions of this License, they do not excuse you from the 
conditions of this License. If you cannot distribute so as to 
satisfy simultaneously your obligations under this License 
and any other pertinent obligations, then as a consequence 
you may not distribute the Program at all. For example, if a 
patent license would not permit royalty-free redistribution 
of the Program by all those who receive copies directly or 
indirectly through you, then the only way you could satisfy 
both it and this License would be to refrain entirely from 
distribution of the Program. 

If any portion of this section is held invalid or 
unenforceable under any particular circumstance, the 
balance of the section is intended to apply and the section 
as a whole is intended to apply in other circumstances. 

It is not the purpose of this section to induce you to 
infringe any patents or other property right claims or to 
contest validity of any such claims; this section has the sole 
purpose of protecting the integrity of the free software 
distribution system, which is implemented by public license 
practices. Many people have made generous contributions 
to the wide range of software distributed through that 
system in reliance on consistent application of that system; 
it is up to the author/donor to decide if he or she is willing 
to distribute software through any other system and a 
licensee cannot impose that choice. 

This section is intended to make thoroughly clear what 
is believed to be a consequence of the rest of this License. 


8. If the distribution and/or use of the Program is 
restricted in certain countries either by patents or by 
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copyrighted interfaces, the original copyright holder who 
places the Program under this License may add an explicit 
geographical distribution limitation excluding those 
countries, so that distribution is permitted only in or among 
countries not thus excluded. In such case, this License 
incorporates the limitation as if written in the body of this 
License. 


9. The Free Software Foundation may publish revised 
and/or new versions of the General Public License from 
time to time. Such new versions will be similar in spirit to 
the present version, but may differ in detail to address new 
problems or concerns. 

Each version is given a distinguishing version number. 
If the Program specifies a version number of this License 
which applies to it and "any later version", you have the 
option of following the terms and conditions either of 
that version or of any later version published by the Free 
Software Foundation. If the Program does not specify a 
version number of this License, you may choose any 
version ever published by the Free Software Foundation. 


10. If you wish to incorporate parts of the Program into 
other free programs whose distribution conditions are 
different, write to the author to ask for permission. For 
software which is copyrighted by the Free Software 
Foundation, write to the Free Software Foundation; we 
sometimes make exceptions for this. Our decision will be 
guided by the two goals of preserving the free status of all 
derivatives of our free software and of promoting the 
sharing and reuse of software generally. 


NO WARRANTY 

11. BECAUSE THE PROGRAM IS LICENSED FREE OF 
CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, 
TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT 
WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT 
HOLDERS AND/OR OTHER PARTIES PROVIDE THE 
PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, 
EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
PERFORMANCE OF THE PROGRAM IS WITH YOU. 
SHOULD THE PROGRAM PROVE DEFECTIVE, YOU 
ASSUME THE COST OF ALL NECESSARY SERVICING, 
REPAIR OR CORRECTION. 


72. IN NO EVENT UNLESS REQUIRED BY APPLICABLE 
LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT 
HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY 
AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED 
ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING 
ANY GENERAL, SPECIAL, INCIDENTAL OR 
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE 
OR INABILITY TO USE THE PROGRAM (INCLUDING BUT 
NOT LIMITED TO LOSS OF DATA OR DATA BEING 
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU 
OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO 
OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH 
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGES. 
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DotBlue.tif, 185 
DotGray.tif, 185 
double dash (--), 23 
download 
binary files, 151 
Web files, 150-151 
Web sites with Wget, 209 
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equal symbol (=), 24 
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exit 
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export command, 94 
.exrc file extension, 75 
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fi, 114 
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file mode, 19 
file permissions, 24-25 
filemode, 29 
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compress, 176-177 
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find by name, 28-29 
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selection, completion, 27 
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find 
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install wget, 208 
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folders, 16 
foreach command, 112-113 
foreach number command, 112 
foregound processing, 100 
foreground (fg) command, 98 
forward slash (/), 16 
-fr option, 35 
Free BSD, 2 
free operating systems, 2 
Free Software Foundation, 2 
ftp command, 134, 146-147, 152 
full pathnames, 21 
function keys, Pico, 62 


G 


g, 24 
gcc 3.1 compiler, 181 
GET command, 229 
GIMP, 288-291, 316 
glob, 26 
glob-patterns, 26 
GNOME Core, 316 
GNOME desktop 
about, 280-281 
applications, 282-283 
GNU general public license, 322-325 
GNU Image Manipulation Program (GIMP), 288-289 
GNU project, 2 
GNU public license, 188 
GnuCash, 316 
Gnumeric spreadsheets, 294-295 
graphical user interface systems, 3 
greater than symbol, 52 
grep -1 command, 47 
grep -v command, 47 
grep command, 10, 46-47, 48 
-group argument, 29 
group of file change, 166-167 
groupname 
find files by, 29 
gunzip, 176-177 
gzip command, 176-177 
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H 


hait command, 156-157 
hang up, 103 

hard link, 168-169 

head command, 44—45, 48 
hidden files, 26, 35 

history codes, 91 

history command, 90, 92 
history variable, 85 

-html file extension, 74 
HTML files, 122 

HTML markup code, 236-237 
httpd command, 152 


-i option, 10, 36 
i£ command, 114 
ifconfig command, 140 
ifree, 171 
image 
crop, 290 
edit images, GIMP, 288-291 
files open, 122 
-iname argument, 29 
incremental backup, 164 
init process, 102 
inodes, 171 
input mode, vi, 66 
insert command, 313 
Insert mode, vi, 69 
insert text, emacs, 77 
install 
Apache modules, 244—245 
application packages, 190-191 
developer tools, 180-185 
Internet Relay Chat (IRC) client, 210-211 
libraries, 202-203 
Lynx Web browser, 204~205 
OroborOSx, 284-285 
Perl modules, 262-265 
pine, 222-223 
tar archives, 192-193 
Weet, 208 
X server, 274-275 
XFree86 upgrades, 276-277 
install command, 190-191 


Interactivity, web site, 242-243 
Internet 

address, 136-137 

dial-up Internet, 134-135 

digital subscriber line (DSL) Internet connection, 134 
Internet Control Message Protocol (ICMP), 142 
Internet Relay Chat (IRC) chat, 212-213 
Internet Service Provider (ISP), 135 
intervening directories, 33 
IP address, 135, 136-137 
iused, 171 


J 


Jaguar Terminal application, Mac OS X 10.2, 5 
jar command, 302-303 

Java applications, 302-303 

Java archive (JAR) files, 302 

jobs command, 98-99 

join text, vi, 73 

jpg file extension, 122 


K 


-k option, 39 
KDEbase, 316 
KDElibs, 316 
Keep in Dock, 4, 5 
keystroke commands 
delete text in vi, 71 
emacs, 77, 79 
Insert mode, vi, 69 
to move through files, 43 
Pico, 61 
keyword search manual, 13 
kill command, 102-103 
kill process 
by job number, 102 
by name, 103 
by process ID, 102 
killall command, 102 


L 


-1 option, 18 

LAN (local area network) connection, 134 
1d, 184 

less command, 42-43, 51 

less than symbol, 52 


> ee 


libraries list, 203 
Library directory, 17 
libtool, 184 
lines, and words in text, 54 
Linux, 2 
list 
active processes, 104-105 
aliases, 83 
current shell variables, 84 
files, 16 
option, vi, 65 
LoadModule command, 244 
local area network (LAN) connection, 134 
log files, 45 
log on to remote system, 144-145 
logoff command, 144 
logout command, 145 
loopback address, 140 
looping shell scripts, 112-113 
1pq command, 172-173 
lpr command, 58-59, 172~173 
1s command, 10, 16, 17, 108 
Lynx, 206-207, 317 


M 


M- (Meta) characters, 40 

Mac OS X, 2, 3 

Mac OS X 10.2, Jaguar Terminal application, 5 
magnifying glass, 291 

mail command, 218-219 

mail inbox, 220 

mailto command, 123 

make clean command, 195 
make command, 196-197, 300-301 
make install command, 195 
man -k command, 13 

man command, 12-13, 42-43 

man enscript command, 59 
manage software installation with Fink, 198-199 
manual access, 12-13 

match patterns with grep, 51 
metacharacters, 254—255 
metadata, 122 

Microsoft Word, 122, 293 

minutes, find files by, 29 

mkdir command, 32-33 

-mmin argument, 29 
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modes, 66 
monitor top processes, 106~107 
mouse use, emacs, 78 
move 
files into directory, 36 
text, Pico, 63 
in vi, 66-67 
Mozilla, 186, 317 
~mtime argument, 29 
multiple files, move, 36 
multiprocess, 97 
mv Command, 22, 36 
MyMac command, 129 
MySQL, 308 


N 


-n option, 56-57 

name Terminal application, 6 

Net BSD, 2 

Netinfo database, 93, 160, 178-179 
netstat command, 140-141 
network connection view, 140-141 
Network Information Center (NIC) database, 138 
new user creation, 158-159 

NF variable, 116 

nidump command, 158-159, 178-179 
niload command, 158, 178-179 
niutil command, 158-159, 178-179 
nobeep variable, 85 

noclobber variable, 85 

non-empty directory, delete, 34 
non-text binary file, 58 

NR variable, 116 

nslookup command, 136-137, 138 
number option, vi, 65 


O 


-o option, 59 
object-oriented programming, 304 
open 
file with emacs, 76-77 
file with Pico, 60-61 
file with vi editor, 64—65 
new line of text, 69 
from shell, Aqua applications, 122-123 
Open BSD, 2 
open command, 122-123 


es >> 


Open, Office Pico | 
documents, 296—297 edit files with, 62-63 | 

- spreadsheets, 298-299 enter text, 61 | 

Open Scripting Architecture (OSA) standard, 130 keystrokes, 61 

open source code, 2 Pine 

Open Source Initiative (OSI), 189 install, 222-223 

Open Source software, 188, 189 send e-mail, 226-227 

OpenOffice, 186 .pinerc file, 223 

OpenOffice.org, 317 ping command, 142-143 

options after command name, 10 pipe (|), 50 

OroborOSx, 284-285 piping, 50, 127 

osascript command, 130 .plist file extension, 74 


POP3 protocol, 145 | 
P popd command, 31 


p command, vi, 73 ports, 141 
package command, 263 POST command, 229 
pager command, 42-43 PostgreSQL, 308-311, 317 
paste buffer, Aqua, 126 PostScript printer, 58 | 
paste buffer, vi, 73 pragma, 265 
paste clipboard in text file, 127 Preview, 122 | 
paste clipboard to standard output, 127 -print argument, 28, 29 
PATH environment variable, 88 Print Center, 173 
path on hard drive, 11 print command, 58, 302 | 
path set, 88 print file on line printer, 58 
path value, 88 print file on postscript printer, 59 | 
path variable, 85 print queue, 172-173 | 
pathname print text on printer, 58-59 | 
designate files by, 21 print underlay, 59 
drag to Terminal window, 133 printenv command, 86 | 
patterns in Perl, 254-255 printf command, 302 | 
pbcopy command, 126 process, 96 | 
pbpaste command, 126 process run in background, 100-101 | 
.pdf file extension, 124 Processes settings, 7 | 
Perl prompt | 
about, 242-243, 307 format codes, 81 
install modules, 262-265 format sequence, 80 | 
patterns, 254-255 set, 80-81 | 
script run, 252-253 prompt2 set, 80 | 
scripts on command line, 256-257 ps -a command, 104-105 | 
write script, 250-251 ps -aux command, 104-105 | 
-perm argument, 29 ps -u command, 104-105 | 
permissions, set, 25 ps -x command, 104-105 
Photoshop, 122 ps command, 104-105 | 
PHP pushd command, 31 
about, 186 pwd command, 10, 30-31 | 
access databases, 314-315 Python applications, 304-305, 307 
applications, 246-247 | 


| 


a 


question mark (?) wildcard, 26, 47 
quit command, 74 

quit Pico, 63 

quotations marks in command line, 10 


R 


-R option, 37 
-r option, 35 
read access, file, 24 
read files, Perl, 258-259 
reboot command, 156-157 
recall 
command history, 90-91 
shell commands, 8 
redirect text to file, 48-49 
regexps, 46 
regular expressions, 46 
relative pathnames, 21 
remote access enable, 152-153 
remote system 
reachable, 142-143 
secure access, 148-149 
rename files, 22 
repeat last command, 90 
reply to e-mail, Pine, 225 
resource forks, 128~129 
restart computer, 156-157 
restart process, 98-99 
restore command, 165 
rlogin command, 15, 144-145 
xm command, 10, 23, 82 
rmdir command, 23, 34-35 
root account, 157 
root user account enable, 160-161 
rootless mode, start XFree86, 278-279 
tf files, 293 
Ruby applications, 306-307 
ruler option, vi, 65 
run from Terminal application, 15 
rw-, 19 


Unix for Mac: 


Your visual blueprint to maximizing 
the foundation of Mac OS X 


S 


save file 

different name, vi, 74 

emacs, 78 

and exit vi, 75 

Pico, 63 

sorted text, 57 

vi, 74-75 

Window settings, 6 
schedule scripts to run automatically, 120-121 
Screen, 317 
screencapture command, 124-125 
screenshot 

capture, 124-125 

edit, 125 
scroll bars, Terminal application, 5 
search for text in files with grep command, 10 
second prompt, 80 
section of screen capture, 124-125 
sed command, 118-119 
selection of files with completion, 27 
send 

e-mail, 218-219 

e-mail Pine, 226-227 
sendmail, configure, 214-215 
sequential commands run, 96 
server 

Apache, 232-233 

X Window System, 268 
set 

autolist command, 27 

prompt, 80-81 

value of shell, 85 

Window Title, 6 
set command, 9, 82-83, 84 
set environment variable, 94 
set noclobber command, 49 
setenv command, 86 
setopt command, 95 
sftp command, 148-149 
shebang line, 253 


shell 


prompt, 4 
settings, 7 
talk, 130 
variables set, 84-85 
shell commands 
about, 3, 10-11 
enter, 8-9 
error correction, 9 
Terminal application and, 4 
use, 11 
shell scripts 
clickable, 132 
conditional, 114-115 
extend with sed command, 118-119 
run, 110-111 
write, 108-109 
show 
file attributes, 18-19 
hidden files, 17 
showmode option, vi, 65, 68 
shut down computer, 156-157 
shutdown command, 156-157 
SIGHUP, 103 
SIGKILL, 103 
signals, 103 
SIGTERM, 103 
simple directives, 232 
size, directory, 38-39 
-size argument, 29 
slogin command, 15 
SmallTalk, 306 
"sniffing" packets, 148 
SOA (statement of authority) record, 138 
Software License Agreement, Developer Tools, 182 
sort command, 56-57 
sort text, 56-57 
source code, 2 
source command, 110-111 
split windows, Terminal application, 5 
spreadsheets 
Gnumeric, 294-295 
Open Office, 298-299 
SQL commands, 312-313 
ssh command, 15, 142 
ssh log on, 148 
standard output, 48 


start 
Apache Web server, 230 
bash from tcsh, 94 
start command, 231 
start new shell, 92 
start zsh from tcsh, 95 
stat command, 145 
statement of authority (SOA) record, 138 
stop 
Apache Web server, 231 
stop command, 231 
stop shutdown, 157 
stopped job, 96 
stopped process, 102-103 
styles, add to Web site, 240-241 
subnet mask, 136-137 
sudo command, 93, 153, 157, 162—163 
sudoers file, 162 
suspend current process, 96~-97 
symbolic links, 168-169 
system administration, 154-155 
system administrator, 154 
system logs inspection, 174-175 
system.log file, 175 


T 


tail command, 44-45 

tar command, 164, 192-193 
.tar files, 177 

.tar.Z files, 177 


TCP/IP (Transmission Control Protocol/Internet 
Protocol), 134 


TCP protocol, 141 
tcsh shell, 92, 115 
.tcshrc file, 89 
telnet command, 15, 134, 142, 144-145, 152 
TERM file, 6, 7 
Terminal application 
about, 3 
configure, 6-7, 79 
start, 4—5 
Unix shells run in, 4 
windows run at same time, 4 
Terminal Inspector panel, 6 
Terminal window 
change appearance, 6 
exit, 14-15 
launch, 4 


text 
chain commands together, 50-51 
in columns, 55 
delete, 70-71 
edit, 72-73 
enter in vi, 68-69 
extract from files, 46-47 
text editors, 60 
text files 
compare, 52-53 
copy to clipboard, 126 
create, 41 
open in TextEdit, 123 
view, 40 
TextEdit, 122 
.tgz files, 177 
then, 114 
tilde (~) alias, 21 
top command, 14, 106-107 
traceroute command, 142-143 
transfer files, 146-147 


Transmission Control Protocol/internet Protocol (TCP/IP), 
134 


true condition, 112 
.txt file extension, 74 


U 


u, 24 

uncompress command, 177 

unig command, 56—57 

University of California, Berkeley, 2 
Unix applications on Web, 186-187 
UNIX history, 2 

Unix manual, 12-13 

unlink command, 261 

unset autolist command, 27 
unset shell variable, 85 

unsetenv command, 86 

uptime command, 107 

Utilities folder, Applications folder, 4, 5 


V 


-v option, 40 
value of environment variable, 87 
verbose option, vi, 65 
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vi 
edit file, 64 
editor options, 65 
keystroke options, 67 
text editor, 60 
view 
binary files, 40 
images, xv, 286-287 
portions of text files, 44—45 
text files, 40 
text files as pages, 42-43 
Vim, 317 
visiblebell variable, 85 
visual editor, 64-65 


W 


we command, 54 
Web browse Lynx, 206-207 
Web files download, 150-151 
Web forms, CGI script, 267 
Web page 
copy, 150 
structured, 238-239 
Web server creation, 152-153 
Web site 
add styles, 240-241 
create, 235 
Darwin source code, 3 
interactivity, 242-243 
open source software, 189 
with Wget, 209 
Web traffic analyze, 248-249 
Weet, 208-209 
which command, 11 
while command, 112-113 
whois command, 138 
wildcard characters, 26 
Wiley Publishing end-user license agreement, 320-321 
Window Settings Panel, 6 
word count command, 54 
word processing, 292-293 
words 
search for in files, 43 
in text count, 54 
write access, file, 24 
write files, Perl, 260-261 


X11, 268 
‘X client, 268 
X server, 3, 268, 274-275 
X Window System 
about, 3 
clients, 268 
desktop, 269 
display, 269 
full screen, 268 
history, 269 
servers and clients, 268 
software, 270-273 
version, 268 


XDarwin, 268 

XFree86 
about, 186, 273, 317 
install upgrades, 276-277 
rootless mode, 278-279 

xhost command, 269 

Xmms, 317 

XTools, 268 

Xv, view images, 286-287 


Z 


Z shell, 92, 95 
.zip files, 177 
zsh, 92 
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